@uniai-fe/util-next 0.2.12 → 0.2.14

package/dist/index.cjs

@@ -60,43 +60,53 @@ var getFetchOptions = ({
   ...typeof headers2 === "undefined" ? {} : { headers: headers2 },
   ...typeof body === "undefined" ? {} : { body }
 });
-async function setTokenRequestHeaders(headerOptions) {
-  console.log(
-    "[setTokenRequestHeaders] headerOptions:",
-    Object.fromEntries(new Headers(headerOptions))
-  );
+async function setTokenRequestHeaders(headerOptions, disabledLog = true) {
+  if (!disabledLog)
+    console.log(
+      "[setTokenRequestHeaders] headerOptions:",
+      Object.fromEntries(new Headers(headerOptions))
+    );
   const nextHeaders = await headers.headers();
   const headerToken = nextHeaders.get("Authorization") || "";
   const cookieToken = (await headers.cookies()).get("token")?.value || "";
-  console.log("[setTokenRequestHeaders] token:", {
-    headers: headerToken,
-    cookie: cookieToken
-  });
+  if (!disabledLog)
+    console.log("[setTokenRequestHeaders] token:", {
+      headers: headerToken,
+      cookie: cookieToken
+    });
   const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : "");
-  console.log("[setTokenRequestHeaders] final token:", token);
+  if (!disabledLog) console.log("[setTokenRequestHeaders] final token:", token);
   if (!token) return void 0;
-  return new Headers({
+  const res = new Headers({
     Authorization: token,
     // Bearer 포함됨
     ...headerOptions
   });
+  if (!disabledLog)
+    console.log(
+      "[setTokenRequestHeaders] final headers:",
+      Object.fromEntries(res)
+    );
+  return res;
 }
 async function authorizedFetch({
   method = "GET",
   disabledToken,
   urlOptions,
   headers: headers2,
-  bodyData
+  bodyData,
+  disabledLog
 }) {
   const { domain, routeUrl, queryUrl } = urlOptions;
   if (!domain && !queryUrl) {
-    nextAPILog(method, routeUrl, "NO URL", {
-      ...urlOptions
-    });
+    if (!disabledLog)
+      nextAPILog(method, routeUrl, "NO URL", {
+        ...urlOptions
+      });
     throw new Error("API \uB3C4\uBA54\uC778 \uB610\uB294 \uACBD\uB85C\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
   }
   const url = generateQueryUrl({ ...urlOptions, method });
-  nextAPILog(method, routeUrl, url, { ...urlOptions });
+  if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });
   const headerOptions = {
     // 외부에서 전달된 헤더
     ...headers2,
@@ -108,11 +118,13 @@ async function authorizedFetch({
   const nativeUrl = `${domain || ""}${queryUrl || ""}${getQueryString(urlOptions.searchParams)}`;
   Object.assign(headerOptions, { "Uniai-Native-URL": nativeUrl });
   const requestHeaders = disabledToken ? new Headers(headerOptions) : await setTokenRequestHeaders(headerOptions);
-  nextAPILog(method, routeUrl, url, {
-    disabledToken,
-    headerOptions,
-    requestHeaders: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
-  });
+  if (!disabledLog) {
+    nextAPILog(method, routeUrl, url, {
+      disabledToken,
+      headers: headerOptions,
+      headerWithToken: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
+    });
+  }
   if (!disabledToken && !requestHeaders) {
     throw new Error("\uC778\uC99D \uC815\uBCF4\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
   }
@@ -121,24 +133,30 @@ async function authorizedFetch({
     headers: requestHeaders
   };
   if (method !== "GET" && bodyData !== void 0) {
-    nextAPILog(method, routeUrl, url, { bodyData });
-    const stringifyData = utilFunctions.convertObjectToSearchParams(bodyData).toString();
-    nextAPILog(method, routeUrl, url, { stringifyData });
+    if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });
+    const stringifyData = utilFunctions.convertObjectToSearchParams(bodyData, {
+      method,
+      urlOptions
+    }).toString();
+    if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });
     if (stringifyData) {
-      nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC788\uC74C" });
+      if (!disabledLog)
+        nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC788\uC74C" });
       Object.assign(fetchOptions, {
         body: ["string", "number"].includes(typeof bodyData) ? String(bodyData) : JSON.stringify(bodyData)
       });
     } else {
-      nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC5C6\uC74C" });
+      if (!disabledLog)
+        nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC5C6\uC74C" });
     }
   }
-  nextAPILog(method, routeUrl, url, {
-    fetchOptions: {
-      ...fetchOptions,
-      headers: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
-    }
-  });
+  if (!disabledLog)
+    nextAPILog(method, routeUrl, url, {
+      fetchOptions: {
+        ...fetchOptions,
+        headers: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
+      }
+    });
   return await fetch(url, getFetchOptions(fetchOptions));
 }
 async function setDebugResponseHeaders({

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../api/src/request/module.ts","../src/server/module.ts","../src/runtime-env/module.ts"],"names":["convertObjectToSearchParams","headers","cookies","NextResponse","checkResponsiveDevice","checkAppleDevice"],"mappings":";;;;;;;AAcO,IAAM,cAAA,GAAiB,CAAC,YAAA,KAAmC;AAEhE,EAAA,MAAM,UAAA,GAAaA,yCAAA,CAA4B,YAAY,CAAA,CAAE,QAAA,EAAA;AAC7D,EAAA,OAAO,UAAA,GAAa,CAAA,CAAA,EAAI,UAAU,CAAA,CAAA,GAAK,EAAA;AACzC,CAAA;AASO,IAAM,UAAA,GAAa,CACxB,MAAA,EACA,QAAA,EACA,aACG,QAAA,KACA;AAOH,EAAA,MAAM,IAAA,uBAAW,IAAA,EAAA;AACjB,EAAA,MAAM,QAAA,GAAW,KAAK,WAAA,EAAA,CAAc,MAAM,GAAG,CAAA,CAAE,CAAC,CAAA,IAAK,EAAA;AACrD,EAAA,MAAM,QAAA,GAAW,CAAA,EAAG,IAAA,CAAK,kBAAA,CAAmB,OAAA,EAAS,EAAE,MAAA,EAAQ,KAAA,EAAO,CAAC,CAAA,CAAA,EAAI,IAAA,CAAK,iBAAiB,CAAA,CAAA;AACjG,EAAA,MAAM,aAAA,GAAgB,OAAO,KAAA,CAAM,GAAG,EAAE,CAAC,CAAA,EAAG,aAAA,IAAiB,GAAA;AAC7D,EAAA,MAAM,cAAA,GAAiB,OAAO,KAAA,CAAM,GAAG,EAAE,CAAC,CAAA,EAAG,aAAA,IAAiB,aAAA;AAE9D,EAAA,OAAO,OAAA,CAAQ,GAAA;AACb,IAAA;;IACA,CAAA,yBAAA,EAAuB,QAAQ,MAAM,QAAQ,CAAA,EAAA,CAAA;AAC7C,IAAA;YAAU,aAAa,CAAA,UAAA,CAAA;AACvB,IAAA;KAAQ,QAAQ,CAAA,CAAA;AAChB,IAAA,GAAI,WACA,CAAC;AAAa,uBAAA,EAAA,cAAc,CAAA,QAAA,CAAA,EAAY;AAAQ,GAAA,EAAA,QAAQ,CAAA,CAAA,EAAI;AAAI,CAAA,CAAA,GAChE,EAAA;IACJ,GAAI,QAAA,GAAW,CAAC,CAAA,GAAI,CAAC,YAAO,GAAG,QAAQ,IAAI,EAAA;AAC3C,IAAA;;AAAA,GAAA;AAEJ,CAAA;AA0BO,IAAM,mBAAmB,CAAC;EAC/B,MAAA,GAAS,KAAA;AACT,EAAA,MAAA;AACA,EAAA,QAAA;AACA,EAAA,QAAA;AACA,EAAA,YAAA;AACA,EAAA,GAAA;AACA,EAAA;AACF,CAAA,KAA0C;AACxC,EAAA,MAAM,GAAA,GAAM,GAAG,MAAM,CAAA,EAAG,QAAQ,CAAA,EAAG,cAAA,CAAe,YAAY,CAAC,CAAA,CAAA;AAE/D,EAAA,IAAI,CAAC,WAAA,EAAa;AAChB,IAAA,UAAA,CAAW,MAAA,EAAQ,UAAU,GAAA,EAAK;AAChC,MAAA,GAAI,OAAO,EAAA;AACX,MAAA,GAAI,gBAAgB;KACrB,CAAA;AACH,EAAA;AAEA,EAAA,OAAO,GAAA;AACT,CAAA;AAgBO,IAAM,kBAAkB,CAAC;AAC9B,EAAA,MAAA;EACA,OAAA,EAAAC,QAAAA;AACA,EAAA;AACF,CAAA,MAA+C;AAC7C,EAAA,MAAA;;AAEA,EAAA,GAAI,OAAOA,QAAAA,KAAY,WAAA,GAAc,EAAA,GAAK,EAAE,SAAAA,QAAAA,EAAA;AAC5C,EAAA,GAAI,OAAO,IAAA,KAAS,WAAA,GAAc,EAAA,GAAK,EAAE,IAAA;AAC3C,CAAA,CAAA;ACtGA,eAAsB,uBACpB,aAAA,EACkC;AAClC,EAAA,OAAA,CAAQ,GAAA;AAAA,IACN,yCAAA;AAAA,IACA,MAAA,CAAO,WAAA,CAAY,IAAI,OAAA,CAAQ,aAAa,CAAC;AAAA,GAC/C;AACA,EAAA,MAAM,WAAA,GAAc,MAAMA,eAAA,EAAQ;AAClC,EAAA,MAAM,WAAA,GAAc,WAAA,CAAY,GAAA,CAAI,eAAe,CAAA,IAAK,EAAA;AACxD,EAAA,MAAM,eAAe,MAAMC,eAAA,IAAW,GAAA,CAAI,OAAO,GAAG,KAAA,IAAS,EAAA;AAE7D,EAAA,OAAA,CAAQ,IAAI,iCAAA,EAAmC;AAAA,IAC7C,OAAA,EAAS,WAAA;AAAA,IACT,MAAA,EAAQ;AAAA,GACT,CAAA;AAED,EAAA,MAAM,KAAA,GAAQ,WAAA,KAAgB,WAAA,GAAc,CAAA,OAAA,EAAU,WAAW,CAAA,CAAA,GAAK,EAAA,CAAA;AAEtE,EAAA,OAAA,CAAQ,GAAA,CAAI,yCAAyC,KAAK,CAAA;AAE1D,EAAA,IAAI,CAAC,OAAO,OAAO,MAAA;AAEnB,EAAA,OAAO,IAAI,OAAA,CAAQ;AAAA,IACjB,aAAA,EAAe,KAAA;AAAA;AAAA,IACf,GAAG;AAAA,GACJ,CAAA;AACH;AAYA,eAAsB,eAAA,CAAgB;AAAA,EACpC,MAAA,GAAS,KAAA;AAAA,EACT,aAAA;AAAA,EACA,UAAA;AAAA,EACA,OAAA,EAAAD,QAAAA;AAAA,EACA;AACF,CAAA,EAMsB;AACpB,EAAA,MAAM,EAAE,MAAA,EAAQ,QAAA,EAAU,QAAA,EAAS,GAAI,UAAA;AAGvC,EAAA,IAAI,CAAC,MAAA,IAAU,CAAC,QAAA,EAAU;AACxB,IAAA,UAAA,CAAW,MAAA,EAAQ,UAAU,QAAA,EAAU;AAAA,MACrC,GAAG;AAAA,KACJ,CAAA;AAGD,IAAA,MAAM,IAAI,MAAM,iHAA4B,CAAA;AAAA,EAC9C;AAKA,EAAA,MAAM,MAAM,gBAAA,CAAiB,EAAE,GAAG,UAAA,EAAY,QAAQ,CAAA;AACtD,EAAA,UAAA,CAAW,QAAQ,QAAA,EAAU,GAAA,EAAK,EAAE,GAAG,YAAY,CAAA;AAMnD,EAAA,MAAM,aAAA,GAA6B;AAAA;AAAA,IAEjC,GAAGA,QAAAA;AAAA;AAAA,IAEH,+BAAA,EAAiC,MAAA,CAAO,CAAC,CAAC,MAAM,CAAA;AAAA,IAChD,qBAAA,EAAuB,MAAA;AAAA,IACvB,mBAAA,EAAqB;AAAA,GACvB;AAGA,EAAA,MAAM,SAAA,GAAY,CAAA,EAAG,MAAA,IAAU,EAAE,CAAA,EAAG,QAAA,IAAY,EAAE,CAAA,EAAG,cAAA,CAAe,UAAA,CAAW,YAAY,CAAC,CAAA,CAAA;AAC5F,EAAA,MAAA,CAAO,MAAA,CAAO,aAAA,EAAe,EAAE,kBAAA,EAAoB,WAAW,CAAA;AAQ9D,EAAA,MAAM,cAAA,GAAiB,gBACnB,IAAI,OAAA,CAAQ,aAAa,CAAA,GACzB,MAAM,uBAAuB,aAAa,CAAA;AAE9C,EAAA,UAAA,CAAW,MAAA,EAAQ,UAAU,GAAA,EAAK;AAAA,IAChC,aAAA;AAAA,IACA,aAAA;AAAA,IACA,cAAA,EAAgB,iBACZ,MAAA,CAAO,WAAA,CAAY,IAAI,OAAA,CAAQ,cAAc,CAAC,CAAA,GAC9C;AAAA,GACL,CAAA;AAGD,EAAA,IAAI,CAAC,aAAA,IAAiB,CAAC,cAAA,EAAgB;AAErC,IAAA,MAAM,IAAI,MAAM,qFAAoB,CAAA;AAAA,EACtC;AAMA,EAAA,MAAM,YAAA,GAA0C;AAAA,IAC9C,MAAA;AAAA,IACA,OAAA,EAAS;AAAA,GACX;AAGA,EAAA,IAAI,MAAA,KAAW,KAAA,IAAS,QAAA,KAAa,MAAA,EAAW;AAC9C,IAAA,UAAA,CAAW,MAAA,EAAQ,QAAA,EAAU,GAAA,EAAK,EAAE,UAAU,CAAA;AAE9C,IAAA,MAAM,aAAA,GAAgBD,yCAAAA,CAA4B,QAAQ,CAAA,CAAE,QAAA,EAAS;AACrE,IAAA,UAAA,CAAW,MAAA,EAAQ,QAAA,EAAU,GAAA,EAAK,EAAE,eAAe,CAAA;AAEnD,IAAA,IAAI,aAAA,EAAe;AACjB,MAAA,UAAA,CAAW,QAAQ,QAAA,EAAU,GAAA,EAAK,EAAE,OAAA,EAAS,wCAAe,CAAA;AAC5D,MAAA,MAAA,CAAO,OAAO,YAAA,EAAc;AAAA,QAC1B,IAAA,EAAM,CAAC,QAAA,EAAU,QAAQ,EAAE,QAAA,CAAS,OAAO,QAAQ,CAAA,GAC/C,MAAA,CAAO,QAAQ,CAAA,GACf,IAAA,CAAK,UAAU,QAAQ;AAAA,OAC5B,CAAA;AAAA,IACH,CAAA,MAAO;AACL,MAAA,UAAA,CAAW,QAAQ,QAAA,EAAU,GAAA,EAAK,EAAE,OAAA,EAAS,wCAAe,CAAA;AAAA,IAC9D;AAAA,EACF;AAKA,EAAA,UAAA,CAAW,MAAA,EAAQ,UAAU,GAAA,EAAK;AAAA,IAChC,YAAA,EAAc;AAAA,MACZ,GAAG,YAAA;AAAA,MACH,OAAA,EAAS,iBACL,MAAA,CAAO,WAAA,CAAY,IAAI,OAAA,CAAQ,cAAc,CAAC,CAAA,GAC9C;AAAA;AACN,GACD,CAAA;AACD,EAAA,OAAO,MAAM,KAAA,CAAM,GAAA,EAAK,eAAA,CAAgB,YAAY,CAAC,CAAA;AAEvD;AAqBA,eAAsB,uBAAA,CAAsC;AAAA,EAC1D,GAAA;AAAA,EACA,MAAA;AAAA,EACA,QAAA;AAAA,EACA,WAAA;AAAA,EACA,YAAA;AAAA,EACA,OAAA;AAAA,EACA;AACF,CAAA,EAgCyC;AACvC,EAAA,MAAM,uBACJ,OAAO,OAAA,EAAS,UAAA,KAAe,QAAA,IAC/B,MAAM,IAAA,CAAK,OAAA,CAAQ,UAAU,CAAA,CAAE,KAAK,CAAA,IAAA,KAAQ,IAAA,CAAK,UAAA,CAAW,CAAC,IAAI,GAAG,CAAA;AAEtE,EAAA,MAAM,WAAWG,mBAAA,CAAa,IAAA;AAAA,IAC5B,GAAA;AAAA,IACA,uBAAuB,EAAE,GAAG,OAAA,EAAS,UAAA,EAAY,QAAU,GAAI;AAAA,GACjE;AAEA,EAAA,QAAA,CAAS,QAAQ,GAAA,CAAI,+BAAA,EAAiC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;AACtE,EAAA,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,qBAAA,EAAuB,MAAM,CAAA;AAClD,EAAA,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,mBAAA,EAAqB,QAAQ,CAAA;AAElD,EAAA,MAAM,GAAA,GACJ,OAAA,IACA,CAAA,EAAG,MAAA,IAAU,EAAE,CAAA,EAAG,QAAA,IAAY,EAAE,CAAA,EAAG,OAAO,WAAA,KAAgB,QAAA,GAAW,WAAA,GAAc,cAAA,CAAe,YAAY,CAAC,CAAA,CAAA;AACjH,EAAA,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,kBAAA,EAAoB,GAAG,CAAA;AAE5C,EAAA,OAAO,QAAA;AACT;ACvPO,SAAS,qBAAA,CACd,UACA,SAAA,EACc;AACd,EAAA,MAAM,cAAA,GAAiB,QAAA;AAGvB,EAAA,cAAA,CAAe,OAAA,CAAQ,GAAA;AAAA,IACrB,qBAAA;AAAA,IACAC,oCAAsB,SAAS;AAAA,GACjC;AAGA,EAAA,cAAA,CAAe,OAAA,CAAQ,GAAA;AAAA,IACrB,gBAAA;AAAA,IACAC,8BAAA,CAAiB,SAAS,CAAA,GAAI,MAAA,GAAS;AAAA,GACzC;AAEA,EAAA,OAAO,cAAA;AACT","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  method,\n  // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\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","\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n  generateQueryUrl,\n  getFetchOptions,\n  getQueryString,\n  nextAPILog,\n  type API_GenerateQueryUrlParams,\n  type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/**\n * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n *\n * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n */\nexport async function setTokenRequestHeaders(\n  headerOptions?: HeadersInit,\n): Promise<HeadersInit | undefined> {\n  console.log(\n    \"[setTokenRequestHeaders] headerOptions:\",\n    Object.fromEntries(new Headers(headerOptions)),\n  );\n  const nextHeaders = await headers();\n  const headerToken = nextHeaders.get(\"Authorization\") || \"\";\n  const cookieToken = (await cookies()).get(\"token\")?.value || \"\";\n\n  console.log(\"[setTokenRequestHeaders] token:\", {\n    headers: headerToken,\n    cookie: cookieToken,\n  });\n  // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n  const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n  console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n  if (!token) return undefined;\n\n  return new Headers({\n    Authorization: token, // Bearer 포함됨\n    ...headerOptions,\n  });\n}\n\n/**\n * 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @returns {Promise<Response>} fetch 응답 객체\n */\nexport async function authorizedFetch({\n  method = \"GET\",\n  disabledToken,\n  urlOptions,\n  headers,\n  bodyData,\n}: {\n  method?: string;\n  disabledToken?: boolean;\n  urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n  headers?: HeadersInit;\n  bodyData?: object;\n}): Promise<Response> {\n  const { domain, routeUrl, queryUrl } = urlOptions;\n\n  // 기초 데이터 검증\n  if (!domain && !queryUrl) {\n    nextAPILog(method, routeUrl, \"NO URL\", {\n      ...urlOptions,\n    });\n\n    // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n    throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n  }\n\n  // -------------------------- url 구성; start\n\n  // 백엔드 요청 URL\n  const url = generateQueryUrl({ ...urlOptions, method });\n  nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n  // -------------------------- url 구성; end\n\n  // -------------------------- debug headers 구성; start\n\n  const headerOptions: HeadersInit = {\n    // 외부에서 전달된 헤더\n    ...headers,\n    // 백엔드 디버깅용 헤더 추가\n    \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n    \"Uniai-Native-Domain\": domain,\n    \"Uniai-Native-Path\": queryUrl,\n  };\n\n  // 백엔드 요청 URL 전체\n  const nativeUrl = `${domain || \"\"}${queryUrl || \"\"}${getQueryString(urlOptions.searchParams)}`;\n  Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n  // -------------------------- debug headers 구성; end\n\n  // -------------------------- authorization token 구성; start\n\n  // 인증 토큰 추가\n  // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n  const requestHeaders = disabledToken\n    ? new Headers(headerOptions)\n    : await setTokenRequestHeaders(headerOptions);\n\n  nextAPILog(method, routeUrl, url, {\n    disabledToken,\n    headerOptions,\n    requestHeaders: requestHeaders\n      ? Object.fromEntries(new Headers(requestHeaders))\n      : undefined,\n  });\n\n  // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n  if (!disabledToken && !requestHeaders) {\n    // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n    throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n  }\n\n  // -------------------------- authorization token 구성; end\n\n  // -------------------------- fetch options 구성; start\n\n  const fetchOptions: API_GetFetchOptionsParams = {\n    method,\n    headers: requestHeaders,\n  };\n\n  // body 데이터 구성\n  if (method !== \"GET\" && bodyData !== undefined) {\n    nextAPILog(method, routeUrl, url, { bodyData });\n\n    const stringifyData = convertObjectToSearchParams(bodyData).toString();\n    nextAPILog(method, routeUrl, url, { stringifyData });\n\n    if (stringifyData) {\n      nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n      Object.assign(fetchOptions, {\n        body: [\"string\", \"number\"].includes(typeof bodyData)\n          ? String(bodyData)\n          : JSON.stringify(bodyData),\n      });\n    } else {\n      nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n    }\n  }\n\n  // -------------------------- fetch options 구성; end\n\n  // -------------------------- fetch 실행; start\n  nextAPILog(method, routeUrl, url, {\n    fetchOptions: {\n      ...fetchOptions,\n      headers: requestHeaders\n        ? Object.fromEntries(new Headers(requestHeaders))\n        : undefined,\n    },\n  });\n  return await fetch(url, getFetchOptions(fetchOptions));\n  // -------------------------- fetch 실행; end\n}\n\n/**\n * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n */\nexport async function setDebugResponseHeaders<ResponseData>({\n  res,\n  domain,\n  queryUrl,\n  queryString,\n  searchParams,\n  fullUrl,\n  options,\n}: {\n  /**\n   * fetch 응답 데이터\n   */\n  res: ResponseData;\n  /**\n   * API 도메인\n   * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n   * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n   */\n  domain: string;\n  /**\n   * API 엔드포인트 쿼리 path\n   */\n  queryUrl: string;\n} & Partial<{\n  /**\n   * 쿼리스트링\n   */\n  queryString: string;\n  /**\n   * URLSearchParams 객체\n   */\n  searchParams: URLSearchParams | object;\n  /**\n   * 전체 URL\n   */\n  fullUrl: string;\n  /**\n   * 응답 옵션\n   */\n  options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n  const hasInvalidStatusText =\n    typeof options?.statusText === \"string\" &&\n    Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n  // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n  const response = NextResponse.json(\n    res,\n    hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n  );\n\n  response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n  response.headers.set(\"Uniai-Native-Domain\", domain);\n  response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n  const url =\n    fullUrl ||\n    `${domain || \"\"}${queryUrl || \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n  response.headers.set(\"Uniai-Native-URL\", url);\n\n  return response;\n}\n","import type { NextResponse } from \"next/server\";\nimport {\n  checkResponsiveDevice,\n  checkAppleDevice,\n} from \"@uniai-fe/util-functions\";\n\n/**\n * 감지된 기기 환경 저장\n */\nexport function setViewportDeviceInfo(\n  response: NextResponse,\n  userAgent: string,\n): NextResponse {\n  const responseUpdate = response;\n\n  // 접속 디바이스의 브레이크 포인트 체크\n  responseUpdate.headers.set(\n    \"X-Responsive-Device\",\n    checkResponsiveDevice(userAgent),\n  );\n\n  // 접속 디바이스의 애플 기기 여부 체크\n  responseUpdate.headers.set(\n    \"X-Apple-Device\",\n    checkAppleDevice(userAgent) ? \"true\" : \"false\",\n  );\n\n  return responseUpdate;\n}\n"]}
+{"version":3,"sources":["../../api/src/request/module.ts","../src/server/module.ts","../src/runtime-env/module.ts"],"names":["convertObjectToSearchParams","headers","cookies","NextResponse","checkResponsiveDevice","checkAppleDevice"],"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  method,\n  // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\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","\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n  generateQueryUrl,\n  getFetchOptions,\n  getQueryString,\n  nextAPILog,\n  type API_GenerateQueryUrlParams,\n  type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/**\n * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)\n * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n *\n * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n */\nexport async function setTokenRequestHeaders(\n  headerOptions?: HeadersInit,\n  disabledLog: boolean = true,\n): Promise<HeadersInit | undefined> {\n  if (!disabledLog)\n    console.log(\n      \"[setTokenRequestHeaders] headerOptions:\",\n      Object.fromEntries(new Headers(headerOptions)),\n    );\n  const nextHeaders = await headers();\n  const headerToken = nextHeaders.get(\"Authorization\") || \"\";\n  const cookieToken = (await cookies()).get(\"token\")?.value || \"\";\n\n  if (!disabledLog)\n    console.log(\"[setTokenRequestHeaders] token:\", {\n      headers: headerToken,\n      cookie: cookieToken,\n    });\n  // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n  const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n  if (!disabledLog) console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n  if (!token) return undefined;\n\n  const res = new Headers({\n    Authorization: token, // Bearer 포함됨\n    ...headerOptions,\n  });\n\n  if (!disabledLog)\n    console.log(\n      \"[setTokenRequestHeaders] final headers:\",\n      Object.fromEntries(res),\n    );\n\n  return res;\n}\n\n/**\n * 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)\n * @returns {Promise<Response>} fetch 응답 객체\n */\nexport async function authorizedFetch({\n  method = \"GET\",\n  disabledToken,\n  urlOptions,\n  headers,\n  bodyData,\n  disabledLog,\n}: {\n  method?: string;\n  disabledToken?: boolean;\n  urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n  headers?: HeadersInit;\n  bodyData?: object;\n  disabledLog?: boolean;\n}): Promise<Response> {\n  const { domain, routeUrl, queryUrl } = urlOptions;\n\n  // 기초 데이터 검증\n  if (!domain && !queryUrl) {\n    if (!disabledLog)\n      nextAPILog(method, routeUrl, \"NO URL\", {\n        ...urlOptions,\n      });\n\n    // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n    throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n  }\n\n  // -------------------------- url 구성; start\n\n  // 백엔드 요청 URL\n  const url = generateQueryUrl({ ...urlOptions, method });\n  if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n  // -------------------------- url 구성; end\n\n  // -------------------------- debug headers 구성; start\n\n  const headerOptions: HeadersInit = {\n    // 외부에서 전달된 헤더\n    ...headers,\n    // 백엔드 디버깅용 헤더 추가\n    \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n    \"Uniai-Native-Domain\": domain,\n    \"Uniai-Native-Path\": queryUrl,\n  };\n\n  // 백엔드 요청 URL 전체\n  const nativeUrl = `${domain || \"\"}${queryUrl || \"\"}${getQueryString(urlOptions.searchParams)}`;\n  Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n  // -------------------------- debug headers 구성; end\n\n  // -------------------------- authorization token 구성; start\n\n  // 인증 토큰 추가\n  // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n  const requestHeaders = disabledToken\n    ? new Headers(headerOptions)\n    : await setTokenRequestHeaders(headerOptions);\n\n  if (!disabledLog) {\n    nextAPILog(method, routeUrl, url, {\n      disabledToken,\n      headers: headerOptions,\n      headerWithToken: requestHeaders\n        ? Object.fromEntries(new Headers(requestHeaders))\n        : undefined,\n    });\n  }\n\n  // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n  if (!disabledToken && !requestHeaders) {\n    // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n    throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n  }\n\n  // -------------------------- authorization token 구성; end\n\n  // -------------------------- fetch options 구성; start\n\n  const fetchOptions: API_GetFetchOptionsParams = {\n    method,\n    headers: requestHeaders,\n  };\n\n  // body 데이터 구성\n  if (method !== \"GET\" && bodyData !== undefined) {\n    if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });\n\n    const stringifyData = convertObjectToSearchParams(bodyData, {\n      method,\n      urlOptions,\n    }).toString();\n    if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });\n\n    if (stringifyData) {\n      if (!disabledLog)\n        nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n      Object.assign(fetchOptions, {\n        body: [\"string\", \"number\"].includes(typeof bodyData)\n          ? String(bodyData)\n          : JSON.stringify(bodyData),\n      });\n    } else {\n      if (!disabledLog)\n        nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n    }\n  }\n\n  // -------------------------- fetch options 구성; end\n\n  // -------------------------- fetch 실행; start\n  if (!disabledLog)\n    nextAPILog(method, routeUrl, url, {\n      fetchOptions: {\n        ...fetchOptions,\n        headers: requestHeaders\n          ? Object.fromEntries(new Headers(requestHeaders))\n          : undefined,\n      },\n    });\n  return await fetch(url, getFetchOptions(fetchOptions));\n  // -------------------------- fetch 실행; end\n}\n\n/**\n * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n */\nexport async function setDebugResponseHeaders<ResponseData>({\n  res,\n  domain,\n  queryUrl,\n  queryString,\n  searchParams,\n  fullUrl,\n  options,\n}: {\n  /**\n   * fetch 응답 데이터\n   */\n  res: ResponseData;\n  /**\n   * API 도메인\n   * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n   * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n   */\n  domain: string;\n  /**\n   * API 엔드포인트 쿼리 path\n   */\n  queryUrl: string;\n} & Partial<{\n  /**\n   * 쿼리스트링\n   */\n  queryString: string;\n  /**\n   * URLSearchParams 객체\n   */\n  searchParams: URLSearchParams | object;\n  /**\n   * 전체 URL\n   */\n  fullUrl: string;\n  /**\n   * 응답 옵션\n   */\n  options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n  const hasInvalidStatusText =\n    typeof options?.statusText === \"string\" &&\n    Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n  // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n  const response = NextResponse.json(\n    res,\n    hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n  );\n\n  response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n  response.headers.set(\"Uniai-Native-Domain\", domain);\n  response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n  const url =\n    fullUrl ||\n    `${domain || \"\"}${queryUrl || \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n  response.headers.set(\"Uniai-Native-URL\", url);\n\n  return response;\n}\n","import type { NextResponse } from \"next/server\";\nimport {\n  checkResponsiveDevice,\n  checkAppleDevice,\n} from \"@uniai-fe/util-functions\";\n\n/**\n * 감지된 기기 환경 저장\n */\nexport function setViewportDeviceInfo(\n  response: NextResponse,\n  userAgent: string,\n): NextResponse {\n  const responseUpdate = response;\n\n  // 접속 디바이스의 브레이크 포인트 체크\n  responseUpdate.headers.set(\n    \"X-Responsive-Device\",\n    checkResponsiveDevice(userAgent),\n  );\n\n  // 접속 디바이스의 애플 기기 여부 체크\n  responseUpdate.headers.set(\n    \"X-Apple-Device\",\n    checkAppleDevice(userAgent) ? \"true\" : \"false\",\n  );\n\n  return responseUpdate;\n}\n"]}

package/dist/index.d.cts

@@ -4,6 +4,8 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
 /**
  * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.
  * @see middleware.ts
+ * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)
+ * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)
  * @remarks
  * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.
  * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.
@@ -11,7 +13,7 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
  *
  * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined
  */
-declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<HeadersInit | undefined>;
+declare function setTokenRequestHeaders(headerOptions?: HeadersInit, disabledLog?: boolean): Promise<HeadersInit | undefined>;
 /**
  * 인증토큰과 결합한 fetch
  * @util
@@ -20,14 +22,16 @@ declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<He
  * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체
  * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)
  * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체
+ * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)
  * @returns {Promise<Response>} fetch 응답 객체
  */
-declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, }: {
+declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, disabledLog, }: {
     method?: string;
     disabledToken?: boolean;
     urlOptions: Omit<API_GenerateQueryUrlParams, "method">;
     headers?: HeadersInit;
     bodyData?: object;
+    disabledLog?: boolean;
 }): Promise<Response>;
 /**
  * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정

package/dist/index.d.ts

@@ -4,6 +4,8 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
 /**
  * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.
  * @see middleware.ts
+ * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)
+ * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)
  * @remarks
  * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.
  * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.
@@ -11,7 +13,7 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
  *
  * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined
  */
-declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<HeadersInit | undefined>;
+declare function setTokenRequestHeaders(headerOptions?: HeadersInit, disabledLog?: boolean): Promise<HeadersInit | undefined>;
 /**
  * 인증토큰과 결합한 fetch
  * @util
@@ -20,14 +22,16 @@ declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<He
  * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체
  * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)
  * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체
+ * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)
  * @returns {Promise<Response>} fetch 응답 객체
  */
-declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, }: {
+declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, disabledLog, }: {
     method?: string;
     disabledToken?: boolean;
     urlOptions: Omit<API_GenerateQueryUrlParams, "method">;
     headers?: HeadersInit;
     bodyData?: object;
+    disabledLog?: boolean;
 }): Promise<Response>;
 /**
  * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정

package/dist/index.mjs

@@ -58,43 +58,53 @@ var getFetchOptions = ({
   ...typeof headers2 === "undefined" ? {} : { headers: headers2 },
   ...typeof body === "undefined" ? {} : { body }
 });
-async function setTokenRequestHeaders(headerOptions) {
-  console.log(
-    "[setTokenRequestHeaders] headerOptions:",
-    Object.fromEntries(new Headers(headerOptions))
-  );
+async function setTokenRequestHeaders(headerOptions, disabledLog = true) {
+  if (!disabledLog)
+    console.log(
+      "[setTokenRequestHeaders] headerOptions:",
+      Object.fromEntries(new Headers(headerOptions))
+    );
   const nextHeaders = await headers();
   const headerToken = nextHeaders.get("Authorization") || "";
   const cookieToken = (await cookies()).get("token")?.value || "";
-  console.log("[setTokenRequestHeaders] token:", {
-    headers: headerToken,
-    cookie: cookieToken
-  });
+  if (!disabledLog)
+    console.log("[setTokenRequestHeaders] token:", {
+      headers: headerToken,
+      cookie: cookieToken
+    });
   const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : "");
-  console.log("[setTokenRequestHeaders] final token:", token);
+  if (!disabledLog) console.log("[setTokenRequestHeaders] final token:", token);
   if (!token) return void 0;
-  return new Headers({
+  const res = new Headers({
     Authorization: token,
     // Bearer 포함됨
     ...headerOptions
   });
+  if (!disabledLog)
+    console.log(
+      "[setTokenRequestHeaders] final headers:",
+      Object.fromEntries(res)
+    );
+  return res;
 }
 async function authorizedFetch({
   method = "GET",
   disabledToken,
   urlOptions,
   headers: headers2,
-  bodyData
+  bodyData,
+  disabledLog
 }) {
   const { domain, routeUrl, queryUrl } = urlOptions;
   if (!domain && !queryUrl) {
-    nextAPILog(method, routeUrl, "NO URL", {
-      ...urlOptions
-    });
+    if (!disabledLog)
+      nextAPILog(method, routeUrl, "NO URL", {
+        ...urlOptions
+      });
     throw new Error("API \uB3C4\uBA54\uC778 \uB610\uB294 \uACBD\uB85C\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
   }
   const url = generateQueryUrl({ ...urlOptions, method });
-  nextAPILog(method, routeUrl, url, { ...urlOptions });
+  if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });
   const headerOptions = {
     // 외부에서 전달된 헤더
     ...headers2,
@@ -106,11 +116,13 @@ async function authorizedFetch({
   const nativeUrl = `${domain || ""}${queryUrl || ""}${getQueryString(urlOptions.searchParams)}`;
   Object.assign(headerOptions, { "Uniai-Native-URL": nativeUrl });
   const requestHeaders = disabledToken ? new Headers(headerOptions) : await setTokenRequestHeaders(headerOptions);
-  nextAPILog(method, routeUrl, url, {
-    disabledToken,
-    headerOptions,
-    requestHeaders: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
-  });
+  if (!disabledLog) {
+    nextAPILog(method, routeUrl, url, {
+      disabledToken,
+      headers: headerOptions,
+      headerWithToken: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
+    });
+  }
   if (!disabledToken && !requestHeaders) {
     throw new Error("\uC778\uC99D \uC815\uBCF4\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
   }
@@ -119,24 +131,30 @@ async function authorizedFetch({
     headers: requestHeaders
   };
   if (method !== "GET" && bodyData !== void 0) {
-    nextAPILog(method, routeUrl, url, { bodyData });
-    const stringifyData = convertObjectToSearchParams(bodyData).toString();
-    nextAPILog(method, routeUrl, url, { stringifyData });
+    if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });
+    const stringifyData = convertObjectToSearchParams(bodyData, {
+      method,
+      urlOptions
+    }).toString();
+    if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });
     if (stringifyData) {
-      nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC788\uC74C" });
+      if (!disabledLog)
+        nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC788\uC74C" });
       Object.assign(fetchOptions, {
         body: ["string", "number"].includes(typeof bodyData) ? String(bodyData) : JSON.stringify(bodyData)
       });
     } else {
-      nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC5C6\uC74C" });
+      if (!disabledLog)
+        nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC5C6\uC74C" });
     }
   }
-  nextAPILog(method, routeUrl, url, {
-    fetchOptions: {
-      ...fetchOptions,
-      headers: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
-    }
-  });
+  if (!disabledLog)
+    nextAPILog(method, routeUrl, url, {
+      fetchOptions: {
+        ...fetchOptions,
+        headers: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
+      }
+    });
   return await fetch(url, getFetchOptions(fetchOptions));
 }
 async function setDebugResponseHeaders({

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../api/src/request/module.ts","../src/server/module.ts","../src/runtime-env/module.ts"],"names":["headers","convertObjectToSearchParams"],"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  method,\n  // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\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","\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n  generateQueryUrl,\n  getFetchOptions,\n  getQueryString,\n  nextAPILog,\n  type API_GenerateQueryUrlParams,\n  type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/**\n * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n *\n * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n */\nexport async function setTokenRequestHeaders(\n  headerOptions?: HeadersInit,\n): Promise<HeadersInit | undefined> {\n  console.log(\n    \"[setTokenRequestHeaders] headerOptions:\",\n    Object.fromEntries(new Headers(headerOptions)),\n  );\n  const nextHeaders = await headers();\n  const headerToken = nextHeaders.get(\"Authorization\") || \"\";\n  const cookieToken = (await cookies()).get(\"token\")?.value || \"\";\n\n  console.log(\"[setTokenRequestHeaders] token:\", {\n    headers: headerToken,\n    cookie: cookieToken,\n  });\n  // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n  const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n  console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n  if (!token) return undefined;\n\n  return new Headers({\n    Authorization: token, // Bearer 포함됨\n    ...headerOptions,\n  });\n}\n\n/**\n * 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @returns {Promise<Response>} fetch 응답 객체\n */\nexport async function authorizedFetch({\n  method = \"GET\",\n  disabledToken,\n  urlOptions,\n  headers,\n  bodyData,\n}: {\n  method?: string;\n  disabledToken?: boolean;\n  urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n  headers?: HeadersInit;\n  bodyData?: object;\n}): Promise<Response> {\n  const { domain, routeUrl, queryUrl } = urlOptions;\n\n  // 기초 데이터 검증\n  if (!domain && !queryUrl) {\n    nextAPILog(method, routeUrl, \"NO URL\", {\n      ...urlOptions,\n    });\n\n    // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n    throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n  }\n\n  // -------------------------- url 구성; start\n\n  // 백엔드 요청 URL\n  const url = generateQueryUrl({ ...urlOptions, method });\n  nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n  // -------------------------- url 구성; end\n\n  // -------------------------- debug headers 구성; start\n\n  const headerOptions: HeadersInit = {\n    // 외부에서 전달된 헤더\n    ...headers,\n    // 백엔드 디버깅용 헤더 추가\n    \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n    \"Uniai-Native-Domain\": domain,\n    \"Uniai-Native-Path\": queryUrl,\n  };\n\n  // 백엔드 요청 URL 전체\n  const nativeUrl = `${domain || \"\"}${queryUrl || \"\"}${getQueryString(urlOptions.searchParams)}`;\n  Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n  // -------------------------- debug headers 구성; end\n\n  // -------------------------- authorization token 구성; start\n\n  // 인증 토큰 추가\n  // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n  const requestHeaders = disabledToken\n    ? new Headers(headerOptions)\n    : await setTokenRequestHeaders(headerOptions);\n\n  nextAPILog(method, routeUrl, url, {\n    disabledToken,\n    headerOptions,\n    requestHeaders: requestHeaders\n      ? Object.fromEntries(new Headers(requestHeaders))\n      : undefined,\n  });\n\n  // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n  if (!disabledToken && !requestHeaders) {\n    // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n    throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n  }\n\n  // -------------------------- authorization token 구성; end\n\n  // -------------------------- fetch options 구성; start\n\n  const fetchOptions: API_GetFetchOptionsParams = {\n    method,\n    headers: requestHeaders,\n  };\n\n  // body 데이터 구성\n  if (method !== \"GET\" && bodyData !== undefined) {\n    nextAPILog(method, routeUrl, url, { bodyData });\n\n    const stringifyData = convertObjectToSearchParams(bodyData).toString();\n    nextAPILog(method, routeUrl, url, { stringifyData });\n\n    if (stringifyData) {\n      nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n      Object.assign(fetchOptions, {\n        body: [\"string\", \"number\"].includes(typeof bodyData)\n          ? String(bodyData)\n          : JSON.stringify(bodyData),\n      });\n    } else {\n      nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n    }\n  }\n\n  // -------------------------- fetch options 구성; end\n\n  // -------------------------- fetch 실행; start\n  nextAPILog(method, routeUrl, url, {\n    fetchOptions: {\n      ...fetchOptions,\n      headers: requestHeaders\n        ? Object.fromEntries(new Headers(requestHeaders))\n        : undefined,\n    },\n  });\n  return await fetch(url, getFetchOptions(fetchOptions));\n  // -------------------------- fetch 실행; end\n}\n\n/**\n * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n */\nexport async function setDebugResponseHeaders<ResponseData>({\n  res,\n  domain,\n  queryUrl,\n  queryString,\n  searchParams,\n  fullUrl,\n  options,\n}: {\n  /**\n   * fetch 응답 데이터\n   */\n  res: ResponseData;\n  /**\n   * API 도메인\n   * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n   * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n   */\n  domain: string;\n  /**\n   * API 엔드포인트 쿼리 path\n   */\n  queryUrl: string;\n} & Partial<{\n  /**\n   * 쿼리스트링\n   */\n  queryString: string;\n  /**\n   * URLSearchParams 객체\n   */\n  searchParams: URLSearchParams | object;\n  /**\n   * 전체 URL\n   */\n  fullUrl: string;\n  /**\n   * 응답 옵션\n   */\n  options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n  const hasInvalidStatusText =\n    typeof options?.statusText === \"string\" &&\n    Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n  // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n  const response = NextResponse.json(\n    res,\n    hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n  );\n\n  response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n  response.headers.set(\"Uniai-Native-Domain\", domain);\n  response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n  const url =\n    fullUrl ||\n    `${domain || \"\"}${queryUrl || \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n  response.headers.set(\"Uniai-Native-URL\", url);\n\n  return response;\n}\n","import type { NextResponse } from \"next/server\";\nimport {\n  checkResponsiveDevice,\n  checkAppleDevice,\n} from \"@uniai-fe/util-functions\";\n\n/**\n * 감지된 기기 환경 저장\n */\nexport function setViewportDeviceInfo(\n  response: NextResponse,\n  userAgent: string,\n): NextResponse {\n  const responseUpdate = response;\n\n  // 접속 디바이스의 브레이크 포인트 체크\n  responseUpdate.headers.set(\n    \"X-Responsive-Device\",\n    checkResponsiveDevice(userAgent),\n  );\n\n  // 접속 디바이스의 애플 기기 여부 체크\n  responseUpdate.headers.set(\n    \"X-Apple-Device\",\n    checkAppleDevice(userAgent) ? \"true\" : \"false\",\n  );\n\n  return responseUpdate;\n}\n"]}
+{"version":3,"sources":["../../api/src/request/module.ts","../src/server/module.ts","../src/runtime-env/module.ts"],"names":["headers","convertObjectToSearchParams"],"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  method,\n  // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\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","\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n  generateQueryUrl,\n  getFetchOptions,\n  getQueryString,\n  nextAPILog,\n  type API_GenerateQueryUrlParams,\n  type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/**\n * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)\n * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n *\n * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n */\nexport async function setTokenRequestHeaders(\n  headerOptions?: HeadersInit,\n  disabledLog: boolean = true,\n): Promise<HeadersInit | undefined> {\n  if (!disabledLog)\n    console.log(\n      \"[setTokenRequestHeaders] headerOptions:\",\n      Object.fromEntries(new Headers(headerOptions)),\n    );\n  const nextHeaders = await headers();\n  const headerToken = nextHeaders.get(\"Authorization\") || \"\";\n  const cookieToken = (await cookies()).get(\"token\")?.value || \"\";\n\n  if (!disabledLog)\n    console.log(\"[setTokenRequestHeaders] token:\", {\n      headers: headerToken,\n      cookie: cookieToken,\n    });\n  // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n  const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n  if (!disabledLog) console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n  if (!token) return undefined;\n\n  const res = new Headers({\n    Authorization: token, // Bearer 포함됨\n    ...headerOptions,\n  });\n\n  if (!disabledLog)\n    console.log(\n      \"[setTokenRequestHeaders] final headers:\",\n      Object.fromEntries(res),\n    );\n\n  return res;\n}\n\n/**\n * 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)\n * @returns {Promise<Response>} fetch 응답 객체\n */\nexport async function authorizedFetch({\n  method = \"GET\",\n  disabledToken,\n  urlOptions,\n  headers,\n  bodyData,\n  disabledLog,\n}: {\n  method?: string;\n  disabledToken?: boolean;\n  urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n  headers?: HeadersInit;\n  bodyData?: object;\n  disabledLog?: boolean;\n}): Promise<Response> {\n  const { domain, routeUrl, queryUrl } = urlOptions;\n\n  // 기초 데이터 검증\n  if (!domain && !queryUrl) {\n    if (!disabledLog)\n      nextAPILog(method, routeUrl, \"NO URL\", {\n        ...urlOptions,\n      });\n\n    // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n    throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n  }\n\n  // -------------------------- url 구성; start\n\n  // 백엔드 요청 URL\n  const url = generateQueryUrl({ ...urlOptions, method });\n  if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n  // -------------------------- url 구성; end\n\n  // -------------------------- debug headers 구성; start\n\n  const headerOptions: HeadersInit = {\n    // 외부에서 전달된 헤더\n    ...headers,\n    // 백엔드 디버깅용 헤더 추가\n    \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n    \"Uniai-Native-Domain\": domain,\n    \"Uniai-Native-Path\": queryUrl,\n  };\n\n  // 백엔드 요청 URL 전체\n  const nativeUrl = `${domain || \"\"}${queryUrl || \"\"}${getQueryString(urlOptions.searchParams)}`;\n  Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n  // -------------------------- debug headers 구성; end\n\n  // -------------------------- authorization token 구성; start\n\n  // 인증 토큰 추가\n  // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n  const requestHeaders = disabledToken\n    ? new Headers(headerOptions)\n    : await setTokenRequestHeaders(headerOptions);\n\n  if (!disabledLog) {\n    nextAPILog(method, routeUrl, url, {\n      disabledToken,\n      headers: headerOptions,\n      headerWithToken: requestHeaders\n        ? Object.fromEntries(new Headers(requestHeaders))\n        : undefined,\n    });\n  }\n\n  // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n  if (!disabledToken && !requestHeaders) {\n    // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n    throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n  }\n\n  // -------------------------- authorization token 구성; end\n\n  // -------------------------- fetch options 구성; start\n\n  const fetchOptions: API_GetFetchOptionsParams = {\n    method,\n    headers: requestHeaders,\n  };\n\n  // body 데이터 구성\n  if (method !== \"GET\" && bodyData !== undefined) {\n    if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });\n\n    const stringifyData = convertObjectToSearchParams(bodyData, {\n      method,\n      urlOptions,\n    }).toString();\n    if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });\n\n    if (stringifyData) {\n      if (!disabledLog)\n        nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n      Object.assign(fetchOptions, {\n        body: [\"string\", \"number\"].includes(typeof bodyData)\n          ? String(bodyData)\n          : JSON.stringify(bodyData),\n      });\n    } else {\n      if (!disabledLog)\n        nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n    }\n  }\n\n  // -------------------------- fetch options 구성; end\n\n  // -------------------------- fetch 실행; start\n  if (!disabledLog)\n    nextAPILog(method, routeUrl, url, {\n      fetchOptions: {\n        ...fetchOptions,\n        headers: requestHeaders\n          ? Object.fromEntries(new Headers(requestHeaders))\n          : undefined,\n      },\n    });\n  return await fetch(url, getFetchOptions(fetchOptions));\n  // -------------------------- fetch 실행; end\n}\n\n/**\n * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n */\nexport async function setDebugResponseHeaders<ResponseData>({\n  res,\n  domain,\n  queryUrl,\n  queryString,\n  searchParams,\n  fullUrl,\n  options,\n}: {\n  /**\n   * fetch 응답 데이터\n   */\n  res: ResponseData;\n  /**\n   * API 도메인\n   * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n   * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n   */\n  domain: string;\n  /**\n   * API 엔드포인트 쿼리 path\n   */\n  queryUrl: string;\n} & Partial<{\n  /**\n   * 쿼리스트링\n   */\n  queryString: string;\n  /**\n   * URLSearchParams 객체\n   */\n  searchParams: URLSearchParams | object;\n  /**\n   * 전체 URL\n   */\n  fullUrl: string;\n  /**\n   * 응답 옵션\n   */\n  options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n  const hasInvalidStatusText =\n    typeof options?.statusText === \"string\" &&\n    Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n  // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n  const response = NextResponse.json(\n    res,\n    hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n  );\n\n  response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n  response.headers.set(\"Uniai-Native-Domain\", domain);\n  response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n  const url =\n    fullUrl ||\n    `${domain || \"\"}${queryUrl || \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n  response.headers.set(\"Uniai-Native-URL\", url);\n\n  return response;\n}\n","import type { NextResponse } from \"next/server\";\nimport {\n  checkResponsiveDevice,\n  checkAppleDevice,\n} from \"@uniai-fe/util-functions\";\n\n/**\n * 감지된 기기 환경 저장\n */\nexport function setViewportDeviceInfo(\n  response: NextResponse,\n  userAgent: string,\n): NextResponse {\n  const responseUpdate = response;\n\n  // 접속 디바이스의 브레이크 포인트 체크\n  responseUpdate.headers.set(\n    \"X-Responsive-Device\",\n    checkResponsiveDevice(userAgent),\n  );\n\n  // 접속 디바이스의 애플 기기 여부 체크\n  responseUpdate.headers.set(\n    \"X-Apple-Device\",\n    checkAppleDevice(userAgent) ? \"true\" : \"false\",\n  );\n\n  return responseUpdate;\n}\n"]}

package/dist/server/index.cjs

@@ -90,43 +90,53 @@ var getFetchOptions = ({
 
 // src/server/module.ts
 var import_util_functions2 = require("@uniai-fe/util-functions");
-async function setTokenRequestHeaders(headerOptions) {
-  console.log(
-    "[setTokenRequestHeaders] headerOptions:",
-    Object.fromEntries(new Headers(headerOptions))
-  );
+async function setTokenRequestHeaders(headerOptions, disabledLog = true) {
+  if (!disabledLog)
+    console.log(
+      "[setTokenRequestHeaders] headerOptions:",
+      Object.fromEntries(new Headers(headerOptions))
+    );
   const nextHeaders = await (0, import_headers.headers)();
   const headerToken = nextHeaders.get("Authorization") || "";
   const cookieToken = (await (0, import_headers.cookies)()).get("token")?.value || "";
-  console.log("[setTokenRequestHeaders] token:", {
-    headers: headerToken,
-    cookie: cookieToken
-  });
+  if (!disabledLog)
+    console.log("[setTokenRequestHeaders] token:", {
+      headers: headerToken,
+      cookie: cookieToken
+    });
   const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : "");
-  console.log("[setTokenRequestHeaders] final token:", token);
+  if (!disabledLog) console.log("[setTokenRequestHeaders] final token:", token);
   if (!token) return void 0;
-  return new Headers({
+  const res = new Headers({
     Authorization: token,
     // Bearer 포함됨
     ...headerOptions
   });
+  if (!disabledLog)
+    console.log(
+      "[setTokenRequestHeaders] final headers:",
+      Object.fromEntries(res)
+    );
+  return res;
 }
 async function authorizedFetch({
   method = "GET",
   disabledToken,
   urlOptions,
   headers: headers2,
-  bodyData
+  bodyData,
+  disabledLog
 }) {
   const { domain, routeUrl, queryUrl } = urlOptions;
   if (!domain && !queryUrl) {
-    nextAPILog(method, routeUrl, "NO URL", {
-      ...urlOptions
-    });
+    if (!disabledLog)
+      nextAPILog(method, routeUrl, "NO URL", {
+        ...urlOptions
+      });
     throw new Error("API \uB3C4\uBA54\uC778 \uB610\uB294 \uACBD\uB85C\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
   }
   const url = generateQueryUrl({ ...urlOptions, method });
-  nextAPILog(method, routeUrl, url, { ...urlOptions });
+  if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });
   const headerOptions = {
     // 외부에서 전달된 헤더
     ...headers2,
@@ -138,11 +148,13 @@ async function authorizedFetch({
   const nativeUrl = `${domain || ""}${queryUrl || ""}${getQueryString(urlOptions.searchParams)}`;
   Object.assign(headerOptions, { "Uniai-Native-URL": nativeUrl });
   const requestHeaders = disabledToken ? new Headers(headerOptions) : await setTokenRequestHeaders(headerOptions);
-  nextAPILog(method, routeUrl, url, {
-    disabledToken,
-    headerOptions,
-    requestHeaders: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
-  });
+  if (!disabledLog) {
+    nextAPILog(method, routeUrl, url, {
+      disabledToken,
+      headers: headerOptions,
+      headerWithToken: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
+    });
+  }
   if (!disabledToken && !requestHeaders) {
     throw new Error("\uC778\uC99D \uC815\uBCF4\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
   }
@@ -151,24 +163,30 @@ async function authorizedFetch({
     headers: requestHeaders
   };
   if (method !== "GET" && bodyData !== void 0) {
-    nextAPILog(method, routeUrl, url, { bodyData });
-    const stringifyData = (0, import_util_functions2.convertObjectToSearchParams)(bodyData).toString();
-    nextAPILog(method, routeUrl, url, { stringifyData });
+    if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });
+    const stringifyData = (0, import_util_functions2.convertObjectToSearchParams)(bodyData, {
+      method,
+      urlOptions
+    }).toString();
+    if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });
     if (stringifyData) {
-      nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC788\uC74C" });
+      if (!disabledLog)
+        nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC788\uC74C" });
       Object.assign(fetchOptions, {
         body: ["string", "number"].includes(typeof bodyData) ? String(bodyData) : JSON.stringify(bodyData)
       });
     } else {
-      nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC5C6\uC74C" });
+      if (!disabledLog)
+        nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC5C6\uC74C" });
     }
   }
-  nextAPILog(method, routeUrl, url, {
-    fetchOptions: {
-      ...fetchOptions,
-      headers: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
-    }
-  });
+  if (!disabledLog)
+    nextAPILog(method, routeUrl, url, {
+      fetchOptions: {
+        ...fetchOptions,
+        headers: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
+      }
+    });
   return await fetch(url, getFetchOptions(fetchOptions));
 }
 async function setDebugResponseHeaders({

package/dist/server/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/index.ts","../../src/server/module.ts","../../../api/src/response/module.ts","../../../api/src/request/module.ts"],"sourcesContent":["export * from \"./module\";\n","\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n  generateQueryUrl,\n  getFetchOptions,\n  getQueryString,\n  nextAPILog,\n  type API_GenerateQueryUrlParams,\n  type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/**\n * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n *\n * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n */\nexport async function setTokenRequestHeaders(\n  headerOptions?: HeadersInit,\n): Promise<HeadersInit | undefined> {\n  console.log(\n    \"[setTokenRequestHeaders] headerOptions:\",\n    Object.fromEntries(new Headers(headerOptions)),\n  );\n  const nextHeaders = await headers();\n  const headerToken = nextHeaders.get(\"Authorization\") || \"\";\n  const cookieToken = (await cookies()).get(\"token\")?.value || \"\";\n\n  console.log(\"[setTokenRequestHeaders] token:\", {\n    headers: headerToken,\n    cookie: cookieToken,\n  });\n  // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n  const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n  console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n  if (!token) return undefined;\n\n  return new Headers({\n    Authorization: token, // Bearer 포함됨\n    ...headerOptions,\n  });\n}\n\n/**\n * 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @returns {Promise<Response>} fetch 응답 객체\n */\nexport async function authorizedFetch({\n  method = \"GET\",\n  disabledToken,\n  urlOptions,\n  headers,\n  bodyData,\n}: {\n  method?: string;\n  disabledToken?: boolean;\n  urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n  headers?: HeadersInit;\n  bodyData?: object;\n}): Promise<Response> {\n  const { domain, routeUrl, queryUrl } = urlOptions;\n\n  // 기초 데이터 검증\n  if (!domain && !queryUrl) {\n    nextAPILog(method, routeUrl, \"NO URL\", {\n      ...urlOptions,\n    });\n\n    // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n    throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n  }\n\n  // -------------------------- url 구성; start\n\n  // 백엔드 요청 URL\n  const url = generateQueryUrl({ ...urlOptions, method });\n  nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n  // -------------------------- url 구성; end\n\n  // -------------------------- debug headers 구성; start\n\n  const headerOptions: HeadersInit = {\n    // 외부에서 전달된 헤더\n    ...headers,\n    // 백엔드 디버깅용 헤더 추가\n    \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n    \"Uniai-Native-Domain\": domain,\n    \"Uniai-Native-Path\": queryUrl,\n  };\n\n  // 백엔드 요청 URL 전체\n  const nativeUrl = `${domain || \"\"}${queryUrl || \"\"}${getQueryString(urlOptions.searchParams)}`;\n  Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n  // -------------------------- debug headers 구성; end\n\n  // -------------------------- authorization token 구성; start\n\n  // 인증 토큰 추가\n  // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n  const requestHeaders = disabledToken\n    ? new Headers(headerOptions)\n    : await setTokenRequestHeaders(headerOptions);\n\n  nextAPILog(method, routeUrl, url, {\n    disabledToken,\n    headerOptions,\n    requestHeaders: requestHeaders\n      ? Object.fromEntries(new Headers(requestHeaders))\n      : undefined,\n  });\n\n  // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n  if (!disabledToken && !requestHeaders) {\n    // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n    throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n  }\n\n  // -------------------------- authorization token 구성; end\n\n  // -------------------------- fetch options 구성; start\n\n  const fetchOptions: API_GetFetchOptionsParams = {\n    method,\n    headers: requestHeaders,\n  };\n\n  // body 데이터 구성\n  if (method !== \"GET\" && bodyData !== undefined) {\n    nextAPILog(method, routeUrl, url, { bodyData });\n\n    const stringifyData = convertObjectToSearchParams(bodyData).toString();\n    nextAPILog(method, routeUrl, url, { stringifyData });\n\n    if (stringifyData) {\n      nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n      Object.assign(fetchOptions, {\n        body: [\"string\", \"number\"].includes(typeof bodyData)\n          ? String(bodyData)\n          : JSON.stringify(bodyData),\n      });\n    } else {\n      nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n    }\n  }\n\n  // -------------------------- fetch options 구성; end\n\n  // -------------------------- fetch 실행; start\n  nextAPILog(method, routeUrl, url, {\n    fetchOptions: {\n      ...fetchOptions,\n      headers: requestHeaders\n        ? Object.fromEntries(new Headers(requestHeaders))\n        : undefined,\n    },\n  });\n  return await fetch(url, getFetchOptions(fetchOptions));\n  // -------------------------- fetch 실행; end\n}\n\n/**\n * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n */\nexport async function setDebugResponseHeaders<ResponseData>({\n  res,\n  domain,\n  queryUrl,\n  queryString,\n  searchParams,\n  fullUrl,\n  options,\n}: {\n  /**\n   * fetch 응답 데이터\n   */\n  res: ResponseData;\n  /**\n   * API 도메인\n   * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n   * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n   */\n  domain: string;\n  /**\n   * API 엔드포인트 쿼리 path\n   */\n  queryUrl: string;\n} & Partial<{\n  /**\n   * 쿼리스트링\n   */\n  queryString: string;\n  /**\n   * URLSearchParams 객체\n   */\n  searchParams: URLSearchParams | object;\n  /**\n   * 전체 URL\n   */\n  fullUrl: string;\n  /**\n   * 응답 옵션\n   */\n  options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n  const hasInvalidStatusText =\n    typeof options?.statusText === \"string\" &&\n    Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n  // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n  const response = NextResponse.json(\n    res,\n    hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n  );\n\n  response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n  response.headers.set(\"Uniai-Native-Domain\", domain);\n  response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n  const url =\n    fullUrl ||\n    `${domain || \"\"}${queryUrl || \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n  response.headers.set(\"Uniai-Native-URL\", url);\n\n  return response;\n}\n","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  method,\n  // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\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"],"mappings":"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","names":["headers","import_util_functions","headers"]}
+{"version":3,"sources":["../../src/server/index.ts","../../src/server/module.ts","../../../api/src/response/module.ts","../../../api/src/request/module.ts"],"sourcesContent":["export * from \"./module\";\n","\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n  generateQueryUrl,\n  getFetchOptions,\n  getQueryString,\n  nextAPILog,\n  type API_GenerateQueryUrlParams,\n  type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/**\n * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)\n * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n *\n * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n */\nexport async function setTokenRequestHeaders(\n  headerOptions?: HeadersInit,\n  disabledLog: boolean = true,\n): Promise<HeadersInit | undefined> {\n  if (!disabledLog)\n    console.log(\n      \"[setTokenRequestHeaders] headerOptions:\",\n      Object.fromEntries(new Headers(headerOptions)),\n    );\n  const nextHeaders = await headers();\n  const headerToken = nextHeaders.get(\"Authorization\") || \"\";\n  const cookieToken = (await cookies()).get(\"token\")?.value || \"\";\n\n  if (!disabledLog)\n    console.log(\"[setTokenRequestHeaders] token:\", {\n      headers: headerToken,\n      cookie: cookieToken,\n    });\n  // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n  const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n  if (!disabledLog) console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n  if (!token) return undefined;\n\n  const res = new Headers({\n    Authorization: token, // Bearer 포함됨\n    ...headerOptions,\n  });\n\n  if (!disabledLog)\n    console.log(\n      \"[setTokenRequestHeaders] final headers:\",\n      Object.fromEntries(res),\n    );\n\n  return res;\n}\n\n/**\n * 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)\n * @returns {Promise<Response>} fetch 응답 객체\n */\nexport async function authorizedFetch({\n  method = \"GET\",\n  disabledToken,\n  urlOptions,\n  headers,\n  bodyData,\n  disabledLog,\n}: {\n  method?: string;\n  disabledToken?: boolean;\n  urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n  headers?: HeadersInit;\n  bodyData?: object;\n  disabledLog?: boolean;\n}): Promise<Response> {\n  const { domain, routeUrl, queryUrl } = urlOptions;\n\n  // 기초 데이터 검증\n  if (!domain && !queryUrl) {\n    if (!disabledLog)\n      nextAPILog(method, routeUrl, \"NO URL\", {\n        ...urlOptions,\n      });\n\n    // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n    throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n  }\n\n  // -------------------------- url 구성; start\n\n  // 백엔드 요청 URL\n  const url = generateQueryUrl({ ...urlOptions, method });\n  if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n  // -------------------------- url 구성; end\n\n  // -------------------------- debug headers 구성; start\n\n  const headerOptions: HeadersInit = {\n    // 외부에서 전달된 헤더\n    ...headers,\n    // 백엔드 디버깅용 헤더 추가\n    \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n    \"Uniai-Native-Domain\": domain,\n    \"Uniai-Native-Path\": queryUrl,\n  };\n\n  // 백엔드 요청 URL 전체\n  const nativeUrl = `${domain || \"\"}${queryUrl || \"\"}${getQueryString(urlOptions.searchParams)}`;\n  Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n  // -------------------------- debug headers 구성; end\n\n  // -------------------------- authorization token 구성; start\n\n  // 인증 토큰 추가\n  // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n  const requestHeaders = disabledToken\n    ? new Headers(headerOptions)\n    : await setTokenRequestHeaders(headerOptions);\n\n  if (!disabledLog) {\n    nextAPILog(method, routeUrl, url, {\n      disabledToken,\n      headers: headerOptions,\n      headerWithToken: requestHeaders\n        ? Object.fromEntries(new Headers(requestHeaders))\n        : undefined,\n    });\n  }\n\n  // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n  if (!disabledToken && !requestHeaders) {\n    // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n    throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n  }\n\n  // -------------------------- authorization token 구성; end\n\n  // -------------------------- fetch options 구성; start\n\n  const fetchOptions: API_GetFetchOptionsParams = {\n    method,\n    headers: requestHeaders,\n  };\n\n  // body 데이터 구성\n  if (method !== \"GET\" && bodyData !== undefined) {\n    if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });\n\n    const stringifyData = convertObjectToSearchParams(bodyData, {\n      method,\n      urlOptions,\n    }).toString();\n    if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });\n\n    if (stringifyData) {\n      if (!disabledLog)\n        nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n      Object.assign(fetchOptions, {\n        body: [\"string\", \"number\"].includes(typeof bodyData)\n          ? String(bodyData)\n          : JSON.stringify(bodyData),\n      });\n    } else {\n      if (!disabledLog)\n        nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n    }\n  }\n\n  // -------------------------- fetch options 구성; end\n\n  // -------------------------- fetch 실행; start\n  if (!disabledLog)\n    nextAPILog(method, routeUrl, url, {\n      fetchOptions: {\n        ...fetchOptions,\n        headers: requestHeaders\n          ? Object.fromEntries(new Headers(requestHeaders))\n          : undefined,\n      },\n    });\n  return await fetch(url, getFetchOptions(fetchOptions));\n  // -------------------------- fetch 실행; end\n}\n\n/**\n * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n */\nexport async function setDebugResponseHeaders<ResponseData>({\n  res,\n  domain,\n  queryUrl,\n  queryString,\n  searchParams,\n  fullUrl,\n  options,\n}: {\n  /**\n   * fetch 응답 데이터\n   */\n  res: ResponseData;\n  /**\n   * API 도메인\n   * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n   * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n   */\n  domain: string;\n  /**\n   * API 엔드포인트 쿼리 path\n   */\n  queryUrl: string;\n} & Partial<{\n  /**\n   * 쿼리스트링\n   */\n  queryString: string;\n  /**\n   * URLSearchParams 객체\n   */\n  searchParams: URLSearchParams | object;\n  /**\n   * 전체 URL\n   */\n  fullUrl: string;\n  /**\n   * 응답 옵션\n   */\n  options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n  const hasInvalidStatusText =\n    typeof options?.statusText === \"string\" &&\n    Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n  // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n  const response = NextResponse.json(\n    res,\n    hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n  );\n\n  response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n  response.headers.set(\"Uniai-Native-Domain\", domain);\n  response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n  const url =\n    fullUrl ||\n    `${domain || \"\"}${queryUrl || \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n  response.headers.set(\"Uniai-Native-URL\", url);\n\n  return response;\n}\n","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  method,\n  // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\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"],"mappings":"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","names":["headers","import_util_functions","headers"]}

package/dist/server/index.d.cts

@@ -4,6 +4,8 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
 /**
  * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.
  * @see middleware.ts
+ * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)
+ * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)
  * @remarks
  * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.
  * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.
@@ -11,7 +13,7 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
  *
  * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined
  */
-declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<HeadersInit | undefined>;
+declare function setTokenRequestHeaders(headerOptions?: HeadersInit, disabledLog?: boolean): Promise<HeadersInit | undefined>;
 /**
  * 인증토큰과 결합한 fetch
  * @util
@@ -20,14 +22,16 @@ declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<He
  * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체
  * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)
  * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체
+ * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)
  * @returns {Promise<Response>} fetch 응답 객체
  */
-declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, }: {
+declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, disabledLog, }: {
     method?: string;
     disabledToken?: boolean;
     urlOptions: Omit<API_GenerateQueryUrlParams, "method">;
     headers?: HeadersInit;
     bodyData?: object;
+    disabledLog?: boolean;
 }): Promise<Response>;
 /**
  * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정

package/dist/server/index.d.ts

@@ -4,6 +4,8 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
 /**
  * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.
  * @see middleware.ts
+ * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)
+ * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)
  * @remarks
  * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.
  * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.
@@ -11,7 +13,7 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
  *
  * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined
  */
-declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<HeadersInit | undefined>;
+declare function setTokenRequestHeaders(headerOptions?: HeadersInit, disabledLog?: boolean): Promise<HeadersInit | undefined>;
 /**
  * 인증토큰과 결합한 fetch
  * @util
@@ -20,14 +22,16 @@ declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<He
  * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체
  * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)
  * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체
+ * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)
  * @returns {Promise<Response>} fetch 응답 객체
  */
-declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, }: {
+declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, disabledLog, }: {
     method?: string;
     disabledToken?: boolean;
     urlOptions: Omit<API_GenerateQueryUrlParams, "method">;
     headers?: HeadersInit;
     bodyData?: object;
+    disabledLog?: boolean;
 }): Promise<Response>;
 /**
  * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정

package/dist/server/index.mjs

@@ -62,43 +62,53 @@ var getFetchOptions = ({
 
 // src/server/module.ts
 import { convertObjectToSearchParams as convertObjectToSearchParams2 } from "@uniai-fe/util-functions";
-async function setTokenRequestHeaders(headerOptions) {
-  console.log(
-    "[setTokenRequestHeaders] headerOptions:",
-    Object.fromEntries(new Headers(headerOptions))
-  );
+async function setTokenRequestHeaders(headerOptions, disabledLog = true) {
+  if (!disabledLog)
+    console.log(
+      "[setTokenRequestHeaders] headerOptions:",
+      Object.fromEntries(new Headers(headerOptions))
+    );
   const nextHeaders = await headers();
   const headerToken = nextHeaders.get("Authorization") || "";
   const cookieToken = (await cookies()).get("token")?.value || "";
-  console.log("[setTokenRequestHeaders] token:", {
-    headers: headerToken,
-    cookie: cookieToken
-  });
+  if (!disabledLog)
+    console.log("[setTokenRequestHeaders] token:", {
+      headers: headerToken,
+      cookie: cookieToken
+    });
   const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : "");
-  console.log("[setTokenRequestHeaders] final token:", token);
+  if (!disabledLog) console.log("[setTokenRequestHeaders] final token:", token);
   if (!token) return void 0;
-  return new Headers({
+  const res = new Headers({
     Authorization: token,
     // Bearer 포함됨
     ...headerOptions
   });
+  if (!disabledLog)
+    console.log(
+      "[setTokenRequestHeaders] final headers:",
+      Object.fromEntries(res)
+    );
+  return res;
 }
 async function authorizedFetch({
   method = "GET",
   disabledToken,
   urlOptions,
   headers: headers2,
-  bodyData
+  bodyData,
+  disabledLog
 }) {
   const { domain, routeUrl, queryUrl } = urlOptions;
   if (!domain && !queryUrl) {
-    nextAPILog(method, routeUrl, "NO URL", {
-      ...urlOptions
-    });
+    if (!disabledLog)
+      nextAPILog(method, routeUrl, "NO URL", {
+        ...urlOptions
+      });
     throw new Error("API \uB3C4\uBA54\uC778 \uB610\uB294 \uACBD\uB85C\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
   }
   const url = generateQueryUrl({ ...urlOptions, method });
-  nextAPILog(method, routeUrl, url, { ...urlOptions });
+  if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });
   const headerOptions = {
     // 외부에서 전달된 헤더
     ...headers2,
@@ -110,11 +120,13 @@ async function authorizedFetch({
   const nativeUrl = `${domain || ""}${queryUrl || ""}${getQueryString(urlOptions.searchParams)}`;
   Object.assign(headerOptions, { "Uniai-Native-URL": nativeUrl });
   const requestHeaders = disabledToken ? new Headers(headerOptions) : await setTokenRequestHeaders(headerOptions);
-  nextAPILog(method, routeUrl, url, {
-    disabledToken,
-    headerOptions,
-    requestHeaders: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
-  });
+  if (!disabledLog) {
+    nextAPILog(method, routeUrl, url, {
+      disabledToken,
+      headers: headerOptions,
+      headerWithToken: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
+    });
+  }
   if (!disabledToken && !requestHeaders) {
     throw new Error("\uC778\uC99D \uC815\uBCF4\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
   }
@@ -123,24 +135,30 @@ async function authorizedFetch({
     headers: requestHeaders
   };
   if (method !== "GET" && bodyData !== void 0) {
-    nextAPILog(method, routeUrl, url, { bodyData });
-    const stringifyData = convertObjectToSearchParams2(bodyData).toString();
-    nextAPILog(method, routeUrl, url, { stringifyData });
+    if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });
+    const stringifyData = convertObjectToSearchParams2(bodyData, {
+      method,
+      urlOptions
+    }).toString();
+    if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });
     if (stringifyData) {
-      nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC788\uC74C" });
+      if (!disabledLog)
+        nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC788\uC74C" });
       Object.assign(fetchOptions, {
         body: ["string", "number"].includes(typeof bodyData) ? String(bodyData) : JSON.stringify(bodyData)
       });
     } else {
-      nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC5C6\uC74C" });
+      if (!disabledLog)
+        nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC5C6\uC74C" });
     }
   }
-  nextAPILog(method, routeUrl, url, {
-    fetchOptions: {
-      ...fetchOptions,
-      headers: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
-    }
-  });
+  if (!disabledLog)
+    nextAPILog(method, routeUrl, url, {
+      fetchOptions: {
+        ...fetchOptions,
+        headers: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
+      }
+    });
   return await fetch(url, getFetchOptions(fetchOptions));
 }
 async function setDebugResponseHeaders({

package/dist/server/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/module.ts","../../../api/src/response/module.ts","../../../api/src/request/module.ts"],"sourcesContent":["\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n  generateQueryUrl,\n  getFetchOptions,\n  getQueryString,\n  nextAPILog,\n  type API_GenerateQueryUrlParams,\n  type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/**\n * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n *\n * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n */\nexport async function setTokenRequestHeaders(\n  headerOptions?: HeadersInit,\n): Promise<HeadersInit | undefined> {\n  console.log(\n    \"[setTokenRequestHeaders] headerOptions:\",\n    Object.fromEntries(new Headers(headerOptions)),\n  );\n  const nextHeaders = await headers();\n  const headerToken = nextHeaders.get(\"Authorization\") || \"\";\n  const cookieToken = (await cookies()).get(\"token\")?.value || \"\";\n\n  console.log(\"[setTokenRequestHeaders] token:\", {\n    headers: headerToken,\n    cookie: cookieToken,\n  });\n  // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n  const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n  console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n  if (!token) return undefined;\n\n  return new Headers({\n    Authorization: token, // Bearer 포함됨\n    ...headerOptions,\n  });\n}\n\n/**\n * 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @returns {Promise<Response>} fetch 응답 객체\n */\nexport async function authorizedFetch({\n  method = \"GET\",\n  disabledToken,\n  urlOptions,\n  headers,\n  bodyData,\n}: {\n  method?: string;\n  disabledToken?: boolean;\n  urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n  headers?: HeadersInit;\n  bodyData?: object;\n}): Promise<Response> {\n  const { domain, routeUrl, queryUrl } = urlOptions;\n\n  // 기초 데이터 검증\n  if (!domain && !queryUrl) {\n    nextAPILog(method, routeUrl, \"NO URL\", {\n      ...urlOptions,\n    });\n\n    // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n    throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n  }\n\n  // -------------------------- url 구성; start\n\n  // 백엔드 요청 URL\n  const url = generateQueryUrl({ ...urlOptions, method });\n  nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n  // -------------------------- url 구성; end\n\n  // -------------------------- debug headers 구성; start\n\n  const headerOptions: HeadersInit = {\n    // 외부에서 전달된 헤더\n    ...headers,\n    // 백엔드 디버깅용 헤더 추가\n    \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n    \"Uniai-Native-Domain\": domain,\n    \"Uniai-Native-Path\": queryUrl,\n  };\n\n  // 백엔드 요청 URL 전체\n  const nativeUrl = `${domain || \"\"}${queryUrl || \"\"}${getQueryString(urlOptions.searchParams)}`;\n  Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n  // -------------------------- debug headers 구성; end\n\n  // -------------------------- authorization token 구성; start\n\n  // 인증 토큰 추가\n  // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n  const requestHeaders = disabledToken\n    ? new Headers(headerOptions)\n    : await setTokenRequestHeaders(headerOptions);\n\n  nextAPILog(method, routeUrl, url, {\n    disabledToken,\n    headerOptions,\n    requestHeaders: requestHeaders\n      ? Object.fromEntries(new Headers(requestHeaders))\n      : undefined,\n  });\n\n  // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n  if (!disabledToken && !requestHeaders) {\n    // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n    throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n  }\n\n  // -------------------------- authorization token 구성; end\n\n  // -------------------------- fetch options 구성; start\n\n  const fetchOptions: API_GetFetchOptionsParams = {\n    method,\n    headers: requestHeaders,\n  };\n\n  // body 데이터 구성\n  if (method !== \"GET\" && bodyData !== undefined) {\n    nextAPILog(method, routeUrl, url, { bodyData });\n\n    const stringifyData = convertObjectToSearchParams(bodyData).toString();\n    nextAPILog(method, routeUrl, url, { stringifyData });\n\n    if (stringifyData) {\n      nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n      Object.assign(fetchOptions, {\n        body: [\"string\", \"number\"].includes(typeof bodyData)\n          ? String(bodyData)\n          : JSON.stringify(bodyData),\n      });\n    } else {\n      nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n    }\n  }\n\n  // -------------------------- fetch options 구성; end\n\n  // -------------------------- fetch 실행; start\n  nextAPILog(method, routeUrl, url, {\n    fetchOptions: {\n      ...fetchOptions,\n      headers: requestHeaders\n        ? Object.fromEntries(new Headers(requestHeaders))\n        : undefined,\n    },\n  });\n  return await fetch(url, getFetchOptions(fetchOptions));\n  // -------------------------- fetch 실행; end\n}\n\n/**\n * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n */\nexport async function setDebugResponseHeaders<ResponseData>({\n  res,\n  domain,\n  queryUrl,\n  queryString,\n  searchParams,\n  fullUrl,\n  options,\n}: {\n  /**\n   * fetch 응답 데이터\n   */\n  res: ResponseData;\n  /**\n   * API 도메인\n   * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n   * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n   */\n  domain: string;\n  /**\n   * API 엔드포인트 쿼리 path\n   */\n  queryUrl: string;\n} & Partial<{\n  /**\n   * 쿼리스트링\n   */\n  queryString: string;\n  /**\n   * URLSearchParams 객체\n   */\n  searchParams: URLSearchParams | object;\n  /**\n   * 전체 URL\n   */\n  fullUrl: string;\n  /**\n   * 응답 옵션\n   */\n  options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n  const hasInvalidStatusText =\n    typeof options?.statusText === \"string\" &&\n    Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n  // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n  const response = NextResponse.json(\n    res,\n    hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n  );\n\n  response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n  response.headers.set(\"Uniai-Native-Domain\", domain);\n  response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n  const url =\n    fullUrl ||\n    `${domain || \"\"}${queryUrl || \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n  response.headers.set(\"Uniai-Native-URL\", url);\n\n  return response;\n}\n","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  method,\n  // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\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"],"mappings":";AAEA,SAAS,SAAS,eAAe;AACjC,SAAS,oBAAoB;A;;;AEWtB,IAAM,iBAAiB,CAAC,iBAAmC;AAEhE,QAAM,aAAa,4BAA4B,YAAY,EAAE,SAAA;AAC7D,SAAO,aAAa,IAAI,UAAU,KAAK;AACzC;AASO,IAAM,aAAa,CACxB,QACA,UACA,aACG,aACA;AAOH,QAAM,OAAA,oBAAW,KAAA;AACjB,QAAM,WAAW,KAAK,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC,KAAK;AACrD,QAAM,WAAW,GAAG,KAAK,mBAAmB,SAAS,EAAE,QAAQ,MAAA,CAAO,CAAC,IAAI,KAAK,gBAAA,CAAiB;AACjG,QAAM,gBAAgB,OAAO,MAAM,GAAG,EAAE,CAAC,GAAG,YAAA,KAAiB;AAC7D,QAAM,iBAAiB,OAAO,MAAM,GAAG,EAAE,CAAC,GAAG,YAAA,KAAiB;AAE9D,SAAO,QAAQ;IACb;;IACA,4BAAuB,QAAQ,MAAM,QAAQ;IAC7C;YAAU,aAAa;IACvB;KAAQ,QAAQ;IAChB,GAAI,WACA,CAAC;yBAAa,cAAc,YAAY;KAAQ,QAAQ,IAAI;CAAI,IAChE,CAAA;IACJ,GAAI,WAAW,CAAC,IAAI,CAAC,YAAO,GAAG,QAAQ,IAAI,CAAA;IAC3C;;EAAA;AAEJ;AA0BO,IAAM,mBAAmB,CAAC;EAC/B,SAAS;EACT;EACA;EACA;EACA;EACA;EACA;AACF,MAA0C;AACxC,QAAM,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,eAAe,YAAY,CAAC;AAE/D,MAAI,CAAC,aAAa;AAChB,eAAW,QAAQ,UAAU,KAAK;MAChC,GAAI,OAAO,CAAA;MACX,GAAI,gBAAgB,CAAA;IAAC,CACtB;EACH;AAEA,SAAO;AACT;AAgBO,IAAM,kBAAkB,CAAC;EAC9B;EACA,SAAAA;EACA;AACF,OAA+C;EAC7C;;EAEA,GAAI,OAAOA,aAAY,cAAc,CAAA,IAAK,EAAE,SAAAA,SAAA;EAC5C,GAAI,OAAO,SAAS,cAAc,CAAA,IAAK,EAAE,KAAA;AAC3C;;;AFlHA,SAAS,+BAAAC,oCAAmC;AAY5C,eAAsB,uBACpB,eACkC;AAClC,UAAQ;AAAA,IACN;AAAA,IACA,OAAO,YAAY,IAAI,QAAQ,aAAa,CAAC;AAAA,EAC/C;AACA,QAAM,cAAc,MAAM,QAAQ;AAClC,QAAM,cAAc,YAAY,IAAI,eAAe,KAAK;AACxD,QAAM,eAAe,MAAM,QAAQ,GAAG,IAAI,OAAO,GAAG,SAAS;AAE7D,UAAQ,IAAI,mCAAmC;AAAA,IAC7C,SAAS;AAAA,IACT,QAAQ;AAAA,EACV,CAAC;AAED,QAAM,QAAQ,gBAAgB,cAAc,UAAU,WAAW,KAAK;AAEtE,UAAQ,IAAI,yCAAyC,KAAK;AAE1D,MAAI,CAAC,MAAO,QAAO;AAEnB,SAAO,IAAI,QAAQ;AAAA,IACjB,eAAe;AAAA;AAAA,IACf,GAAG;AAAA,EACL,CAAC;AACH;AAYA,eAAsB,gBAAgB;AAAA,EACpC,SAAS;AAAA,EACT;AAAA,EACA;AAAA,EACA,SAAAC;AAAA,EACA;AACF,GAMsB;AACpB,QAAM,EAAE,QAAQ,UAAU,SAAS,IAAI;AAGvC,MAAI,CAAC,UAAU,CAAC,UAAU;AACxB,eAAW,QAAQ,UAAU,UAAU;AAAA,MACrC,GAAG;AAAA,IACL,CAAC;AAGD,UAAM,IAAI,MAAM,iHAA4B;AAAA,EAC9C;AAKA,QAAM,MAAM,iBAAiB,EAAE,GAAG,YAAY,OAAO,CAAC;AACtD,aAAW,QAAQ,UAAU,KAAK,EAAE,GAAG,WAAW,CAAC;AAMnD,QAAM,gBAA6B;AAAA;AAAA,IAEjC,GAAGA;AAAA;AAAA,IAEH,iCAAiC,OAAO,CAAC,CAAC,MAAM;AAAA,IAChD,uBAAuB;AAAA,IACvB,qBAAqB;AAAA,EACvB;AAGA,QAAM,YAAY,GAAG,UAAU,EAAE,GAAG,YAAY,EAAE,GAAG,eAAe,WAAW,YAAY,CAAC;AAC5F,SAAO,OAAO,eAAe,EAAE,oBAAoB,UAAU,CAAC;AAQ9D,QAAM,iBAAiB,gBACnB,IAAI,QAAQ,aAAa,IACzB,MAAM,uBAAuB,aAAa;AAE9C,aAAW,QAAQ,UAAU,KAAK;AAAA,IAChC;AAAA,IACA;AAAA,IACA,gBAAgB,iBACZ,OAAO,YAAY,IAAI,QAAQ,cAAc,CAAC,IAC9C;AAAA,EACN,CAAC;AAGD,MAAI,CAAC,iBAAiB,CAAC,gBAAgB;AAErC,UAAM,IAAI,MAAM,qFAAoB;AAAA,EACtC;AAMA,QAAM,eAA0C;AAAA,IAC9C;AAAA,IACA,SAAS;AAAA,EACX;AAGA,MAAI,WAAW,SAAS,aAAa,QAAW;AAC9C,eAAW,QAAQ,UAAU,KAAK,EAAE,SAAS,CAAC;AAE9C,UAAM,gBAAgBD,6BAA4B,QAAQ,EAAE,SAAS;AACrE,eAAW,QAAQ,UAAU,KAAK,EAAE,cAAc,CAAC;AAEnD,QAAI,eAAe;AACjB,iBAAW,QAAQ,UAAU,KAAK,EAAE,SAAS,uCAAc,CAAC;AAC5D,aAAO,OAAO,cAAc;AAAA,QAC1B,MAAM,CAAC,UAAU,QAAQ,EAAE,SAAS,OAAO,QAAQ,IAC/C,OAAO,QAAQ,IACf,KAAK,UAAU,QAAQ;AAAA,MAC7B,CAAC;AAAA,IACH,OAAO;AACL,iBAAW,QAAQ,UAAU,KAAK,EAAE,SAAS,uCAAc,CAAC;AAAA,IAC9D;AAAA,EACF;AAKA,aAAW,QAAQ,UAAU,KAAK;AAAA,IAChC,cAAc;AAAA,MACZ,GAAG;AAAA,MACH,SAAS,iBACL,OAAO,YAAY,IAAI,QAAQ,cAAc,CAAC,IAC9C;AAAA,IACN;AAAA,EACF,CAAC;AACD,SAAO,MAAM,MAAM,KAAK,gBAAgB,YAAY,CAAC;AAEvD;AAqBA,eAAsB,wBAAsC;AAAA,EAC1D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAgCyC;AACvC,QAAM,uBACJ,OAAO,SAAS,eAAe,YAC/B,MAAM,KAAK,QAAQ,UAAU,EAAE,KAAK,UAAQ,KAAK,WAAW,CAAC,IAAI,GAAG;AAEtE,QAAM,WAAW,aAAa;AAAA,IAC5B;AAAA,IACA,uBAAuB,EAAE,GAAG,SAAS,YAAY,OAAU,IAAI;AAAA,EACjE;AAEA,WAAS,QAAQ,IAAI,iCAAiC,OAAO,CAAC,CAAC,MAAM,CAAC;AACtE,WAAS,QAAQ,IAAI,uBAAuB,MAAM;AAClD,WAAS,QAAQ,IAAI,qBAAqB,QAAQ;AAElD,QAAM,MACJ,WACA,GAAG,UAAU,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,gBAAgB,WAAW,cAAc,eAAe,YAAY,CAAC;AACjH,WAAS,QAAQ,IAAI,oBAAoB,GAAG;AAE5C,SAAO;AACT;","names":["headers","convertObjectToSearchParams","headers"]}
+{"version":3,"sources":["../../src/server/module.ts","../../../api/src/response/module.ts","../../../api/src/request/module.ts"],"sourcesContent":["\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n  generateQueryUrl,\n  getFetchOptions,\n  getQueryString,\n  nextAPILog,\n  type API_GenerateQueryUrlParams,\n  type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/**\n * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)\n * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n *\n * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n */\nexport async function setTokenRequestHeaders(\n  headerOptions?: HeadersInit,\n  disabledLog: boolean = true,\n): Promise<HeadersInit | undefined> {\n  if (!disabledLog)\n    console.log(\n      \"[setTokenRequestHeaders] headerOptions:\",\n      Object.fromEntries(new Headers(headerOptions)),\n    );\n  const nextHeaders = await headers();\n  const headerToken = nextHeaders.get(\"Authorization\") || \"\";\n  const cookieToken = (await cookies()).get(\"token\")?.value || \"\";\n\n  if (!disabledLog)\n    console.log(\"[setTokenRequestHeaders] token:\", {\n      headers: headerToken,\n      cookie: cookieToken,\n    });\n  // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n  const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n  if (!disabledLog) console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n  if (!token) return undefined;\n\n  const res = new Headers({\n    Authorization: token, // Bearer 포함됨\n    ...headerOptions,\n  });\n\n  if (!disabledLog)\n    console.log(\n      \"[setTokenRequestHeaders] final headers:\",\n      Object.fromEntries(res),\n    );\n\n  return res;\n}\n\n/**\n * 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)\n * @returns {Promise<Response>} fetch 응답 객체\n */\nexport async function authorizedFetch({\n  method = \"GET\",\n  disabledToken,\n  urlOptions,\n  headers,\n  bodyData,\n  disabledLog,\n}: {\n  method?: string;\n  disabledToken?: boolean;\n  urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n  headers?: HeadersInit;\n  bodyData?: object;\n  disabledLog?: boolean;\n}): Promise<Response> {\n  const { domain, routeUrl, queryUrl } = urlOptions;\n\n  // 기초 데이터 검증\n  if (!domain && !queryUrl) {\n    if (!disabledLog)\n      nextAPILog(method, routeUrl, \"NO URL\", {\n        ...urlOptions,\n      });\n\n    // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n    throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n  }\n\n  // -------------------------- url 구성; start\n\n  // 백엔드 요청 URL\n  const url = generateQueryUrl({ ...urlOptions, method });\n  if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n  // -------------------------- url 구성; end\n\n  // -------------------------- debug headers 구성; start\n\n  const headerOptions: HeadersInit = {\n    // 외부에서 전달된 헤더\n    ...headers,\n    // 백엔드 디버깅용 헤더 추가\n    \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n    \"Uniai-Native-Domain\": domain,\n    \"Uniai-Native-Path\": queryUrl,\n  };\n\n  // 백엔드 요청 URL 전체\n  const nativeUrl = `${domain || \"\"}${queryUrl || \"\"}${getQueryString(urlOptions.searchParams)}`;\n  Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n  // -------------------------- debug headers 구성; end\n\n  // -------------------------- authorization token 구성; start\n\n  // 인증 토큰 추가\n  // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n  const requestHeaders = disabledToken\n    ? new Headers(headerOptions)\n    : await setTokenRequestHeaders(headerOptions);\n\n  if (!disabledLog) {\n    nextAPILog(method, routeUrl, url, {\n      disabledToken,\n      headers: headerOptions,\n      headerWithToken: requestHeaders\n        ? Object.fromEntries(new Headers(requestHeaders))\n        : undefined,\n    });\n  }\n\n  // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n  if (!disabledToken && !requestHeaders) {\n    // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n    throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n  }\n\n  // -------------------------- authorization token 구성; end\n\n  // -------------------------- fetch options 구성; start\n\n  const fetchOptions: API_GetFetchOptionsParams = {\n    method,\n    headers: requestHeaders,\n  };\n\n  // body 데이터 구성\n  if (method !== \"GET\" && bodyData !== undefined) {\n    if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });\n\n    const stringifyData = convertObjectToSearchParams(bodyData, {\n      method,\n      urlOptions,\n    }).toString();\n    if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });\n\n    if (stringifyData) {\n      if (!disabledLog)\n        nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n      Object.assign(fetchOptions, {\n        body: [\"string\", \"number\"].includes(typeof bodyData)\n          ? String(bodyData)\n          : JSON.stringify(bodyData),\n      });\n    } else {\n      if (!disabledLog)\n        nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n    }\n  }\n\n  // -------------------------- fetch options 구성; end\n\n  // -------------------------- fetch 실행; start\n  if (!disabledLog)\n    nextAPILog(method, routeUrl, url, {\n      fetchOptions: {\n        ...fetchOptions,\n        headers: requestHeaders\n          ? Object.fromEntries(new Headers(requestHeaders))\n          : undefined,\n      },\n    });\n  return await fetch(url, getFetchOptions(fetchOptions));\n  // -------------------------- fetch 실행; end\n}\n\n/**\n * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n */\nexport async function setDebugResponseHeaders<ResponseData>({\n  res,\n  domain,\n  queryUrl,\n  queryString,\n  searchParams,\n  fullUrl,\n  options,\n}: {\n  /**\n   * fetch 응답 데이터\n   */\n  res: ResponseData;\n  /**\n   * API 도메인\n   * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n   * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n   */\n  domain: string;\n  /**\n   * API 엔드포인트 쿼리 path\n   */\n  queryUrl: string;\n} & Partial<{\n  /**\n   * 쿼리스트링\n   */\n  queryString: string;\n  /**\n   * URLSearchParams 객체\n   */\n  searchParams: URLSearchParams | object;\n  /**\n   * 전체 URL\n   */\n  fullUrl: string;\n  /**\n   * 응답 옵션\n   */\n  options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n  const hasInvalidStatusText =\n    typeof options?.statusText === \"string\" &&\n    Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n  // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n  const response = NextResponse.json(\n    res,\n    hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n  );\n\n  response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n  response.headers.set(\"Uniai-Native-Domain\", domain);\n  response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n  const url =\n    fullUrl ||\n    `${domain || \"\"}${queryUrl || \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n  response.headers.set(\"Uniai-Native-URL\", url);\n\n  return response;\n}\n","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  method,\n  // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\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"],"mappings":"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","names":["headers","convertObjectToSearchParams","headers"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniai-fe/util-next",
-  "version": "0.2.12",
+  "version": "0.2.14",
   "description": "Next.js Utilities for UNIAI FE Projects",
   "type": "module",
   "private": false,