@uniai-fe/util-next 0.2.8 → 0.2.10

package/README.md

@@ -12,6 +12,7 @@ pnpm add @uniai-fe/util-next
 
 ```ts
 import {
+  authorizedFetch,
   setTokenRequestHeaders,
   setDebugResponseHeaders,
 } from "@uniai-fe/util-next/server";
@@ -34,6 +35,22 @@ export async function GET(request: NextRequest) {
     searchParams: request.nextUrl.searchParams,
   });
 }
+
+export async function POST() {
+  const response = await authorizedFetch({
+    method: "POST",
+    urlOptions: {
+      domain: process.env.NATIVE_AI_DOMAIN!,
+      routeUrl: "/api/farms",
+      queryUrl: "/ai/farms",
+    },
+    bodyData: {
+      farm_id: 1,
+    },
+  });
+
+  return response;
+}
 ```
 
 ## Codex 참고용 카탈로그

package/dist/index.cjs

@@ -2,19 +2,135 @@
 
 var headers = require('next/headers');
 var server = require('next/server');
-var api = require('@uniai-fe/util-functions/api');
 var utilFunctions = require('@uniai-fe/util-functions');
 
 // src/server/module.ts
+var getQueryString = (searchParams) => {
+  const serialized = utilFunctions.convertObjectToSearchParams(searchParams).toString();
+  return serialized ? `?${serialized}` : "";
+};
+var nextAPILog = (method, routeUrl, queryUrl, ...messages) => {
+  const date = /* @__PURE__ */ new Date();
+  const dateText = date.toISOString().split("T")[0] ?? "";
+  const timeText = `${date.toLocaleTimeString("en-US", { hour12: false })}.${date.getMilliseconds()}`;
+  const requestMethod = method.split("-")[0]?.toUpperCase() || "-";
+  const responseMethod = method.split("-")[1]?.toUpperCase() || requestMethod;
+  return console.log(
+    `
+`,
+    `[Next Server API] \u23F1 ${dateText} ( ${timeText} )`,
+    `
+  \u03BB [${requestMethod}] FE route`,
+    `
+   ${routeUrl}`,
+    ...queryUrl ? [`
+  \u2550\u23F5 \u03A9 [${responseMethod}] BE url`, `
+   ${queryUrl}`, `
+`] : [],
+    ...messages?.[0] ? [` \u25C7-`, ...messages] : [],
+    `
+`
+  );
+};
+var generateQueryUrl = ({
+  method = "GET",
+  domain,
+  routeUrl,
+  queryUrl,
+  searchParams,
+  log,
+  logDisabled
+}) => {
+  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;
+  if (!logDisabled) {
+    nextAPILog(method, routeUrl, url, {
+      ...log ?? {},
+      ...searchParams ?? {}
+    });
+  }
+  return url;
+};
+var getFetchOptions = ({
+  method,
+  headers: headers2,
+  body
+}) => {
+  const option = { method };
+  if (typeof headers2 !== "undefined" && headers2 && Object.keys(headers2).length > 0)
+    Object.assign(option, { headers: headers2 });
+  if (typeof body !== "undefined" && body) Object.assign(option, { body });
+  return option;
+};
 async function setTokenRequestHeaders(headerOptions) {
   const nextHeaders = await headers.headers();
   const token = nextHeaders.get("Authorization") || "";
   if (!token) return void 0;
   return new Headers({
     Authorization: token,
+    // Bearer 포함됨
     ...headerOptions
   });
 }
+async function authorizedFetch({
+  method = "GET",
+  disabledToken,
+  urlOptions,
+  headers: headers2,
+  bodyData
+}) {
+  const { domain, routeUrl, queryUrl } = urlOptions;
+  if (!domain && !queryUrl) {
+    nextAPILog(method, routeUrl, "NO URL", {
+      ...urlOptions
+    });
+    return new Response("API \uB3C4\uBA54\uC778 \uB610\uB294 \uACBD\uB85C\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.", {
+      status: 500
+    });
+  }
+  const url = generateQueryUrl({ ...urlOptions, method });
+  nextAPILog(method, routeUrl, url, { ...urlOptions });
+  const headerOptions = {
+    // 외부에서 전달된 헤더
+    ...headers2,
+    // 백엔드 디버깅용 헤더 추가
+    "Uniai-Native-Domain-Env-Exist": String(!!domain),
+    "Uniai-Native-Domain": domain,
+    "Uniai-Native-Path": queryUrl
+  };
+  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,
+    headers: headerOptions,
+    headersWithToken: requestHeaders
+  });
+  if (!disabledToken && !requestHeaders) {
+    return new Response("\uC778\uC99D \uC815\uBCF4\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.", {
+      status: 401,
+      headers: headerOptions
+    });
+  }
+  const fetchOptions = {
+    method,
+    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 (stringifyData) {
+      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" });
+    }
+  }
+  nextAPILog(method, routeUrl, url, { fetchOptions });
+  return await fetch(url, getFetchOptions(fetchOptions));
+}
 async function setDebugResponseHeaders({
   res,
   domain,
@@ -28,7 +144,7 @@ async function setDebugResponseHeaders({
   response.headers.set("Uniai-Native-Domain-Env-Exist", String(!!domain));
   response.headers.set("Uniai-Native-Domain", domain);
   response.headers.set("Uniai-Native-Path", queryUrl);
-  const url = fullUrl || `${domain || ""}${queryUrl || ""}${queryString || searchParams ? api.getQueryString(searchParams) : ""}`;
+  const url = fullUrl || `${domain || ""}${queryUrl || ""}${typeof queryString === "string" ? queryString : getQueryString(searchParams)}`;
   response.headers.set("Uniai-Native-URL", url);
   return response;
 }
@@ -45,6 +161,7 @@ function setViewportDeviceInfo(response, userAgent) {
   return responseUpdate;
 }
 
+exports.authorizedFetch = authorizedFetch;
 exports.setDebugResponseHeaders = setDebugResponseHeaders;
 exports.setTokenRequestHeaders = setTokenRequestHeaders;
 exports.setViewportDeviceInfo = setViewportDeviceInfo;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server/module.ts","../src/runtime-env/module.ts"],"names":["headers","NextResponse","getQueryString","checkResponsiveDevice","checkAppleDevice"],"mappings":";;;;;;;;AAgBA,eAAsB,uBACpB,aAAA,EACkC;AAClC,EAAA,MAAM,WAAA,GAAc,MAAMA,eAAA,EAAQ;AAClC,EAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,GAAA,CAAI,eAAe,CAAA,IAAK,EAAA;AAClD,EAAA,IAAI,CAAC,OAAO,OAAO,MAAA;AACnB,EAAA,OAAO,IAAI,OAAA,CAAQ;AAAA,IACjB,aAAA,EAAe,KAAA;AAAA,IACf,GAAG;AAAA,GACJ,CAAA;AACH;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,QAAA,GAAWC,mBAAA,CAAa,IAAA,CAAK,GAAA,EAAK,OAAO,CAAA;AAE/C,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,WAAA,IAAe,YAAA,GAAeC,kBAAA,CAAe,YAAY,IAAI,EAAE,CAAA,CAAA;AACpG,EAAA,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,kBAAA,EAAoB,GAAG,CAAA;AAE5C,EAAA,OAAO,QAAA;AACT;AC3FO,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":["\"use server\";\n\nimport { headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport { getQueryString } from \"@uniai-fe/util-functions/api\";\n\n/**\n * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n *\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  const nextHeaders = await headers();\n  const token = nextHeaders.get(\"Authorization\") || \"\";\n  if (!token) return undefined;\n  return new Headers({\n    Authorization: token,\n    ...headerOptions,\n  });\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 response = NextResponse.json(res, options);\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 || \"\"}${queryString || searchParams ? 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","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  const option: RequestInit = { method };\n\n  // API fetch Headers\n  if (\n    typeof headers !== \"undefined\" &&\n    headers &&\n    Object.keys(headers).length > 0\n  )\n    Object.assign(option, { headers });\n\n  // API fetch Body\n  if (typeof body !== \"undefined\" && body) Object.assign(option, { body });\n\n  return option;\n};\n\n/**\n * API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit | null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\n */\nexport const fetchWithBody = async <\n  BodyDataType = object,\n  ResponseType extends object | Response = Response,\n>({\n  domain,\n  method,\n  routeUrl,\n  queryUrl,\n  searchParams,\n  headers,\n  body,\n  bodyData,\n  isRawResponse,\n  alternateResponse,\n  debug,\n  disabled,\n  disabledLog,\n}: API_FetchWithBodyParams<\n  BodyDataType,\n  ResponseType\n>): Promise<ResponseType> => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n  const option = getFetchOptions({ method, headers, body });\n\n  if (!body && typeof bodyData !== \"undefined\") {\n    // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n    const bodyParams = convertObjectToSearchParams(bodyData).toString();\n    if (bodyParams === \"\") {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (BODY - DATA)\",\n        error: \"데이터가 유효하지 않습니다.\",\n        bodyData,\n        ...(debug ?? {}),\n      });\n      return alternateResponse;\n    }\n    option.body = bodyData as BodyInit;\n  }\n\n  if (!disabledLog) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"READY\",\n      ...option,\n      ...(debug ?? {}),\n    });\n  }\n\n  if (disabled) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"FETCH DISABLED\",\n      message: \"API 요청제한 활성화됨.\",\n    });\n    return alternateResponse;\n  }\n\n  try {\n    const responseRaw = await fetch(url, option);\n    const responseCode = responseRaw.status;\n\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n        code: responseCode,\n      });\n    }\n\n    if (isRawResponse) {\n      return responseRaw as ResponseType;\n    }\n    return (await responseRaw.json()) as ResponseType;\n  } catch (error: unknown) {\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (RESPONSE)\",\n        error,\n        ...(debug ?? {}),\n      });\n    }\n    return alternateResponse;\n  }\n};\n","\"use server\";\n\nimport { 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  const nextHeaders = await headers();\n  const token = nextHeaders.get(\"Authorization\") || \"\";\n  if (!token) return undefined;\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    return new Response(\"API 도메인 또는 경로가 설정되지 않았습니다.\", {\n      status: 500,\n    });\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    headers: headerOptions,\n    headersWithToken: requestHeaders,\n  });\n\n  // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n  if (!disabledToken && !requestHeaders) {\n    return new Response(\"인증 정보를 확인할 수 없습니다.\", {\n      status: 401,\n      headers: headerOptions,\n    });\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, { fetchOptions });\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 response = NextResponse.json(res, options);\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

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

package/dist/index.d.ts

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

package/dist/index.mjs

@@ -1,18 +1,134 @@
 import { headers } from 'next/headers';
 import { NextResponse } from 'next/server';
-import { getQueryString } from '@uniai-fe/util-functions/api';
-import { checkResponsiveDevice, checkAppleDevice } from '@uniai-fe/util-functions';
+import { convertObjectToSearchParams, checkResponsiveDevice, checkAppleDevice } from '@uniai-fe/util-functions';
 
 // src/server/module.ts
+var getQueryString = (searchParams) => {
+  const serialized = convertObjectToSearchParams(searchParams).toString();
+  return serialized ? `?${serialized}` : "";
+};
+var nextAPILog = (method, routeUrl, queryUrl, ...messages) => {
+  const date = /* @__PURE__ */ new Date();
+  const dateText = date.toISOString().split("T")[0] ?? "";
+  const timeText = `${date.toLocaleTimeString("en-US", { hour12: false })}.${date.getMilliseconds()}`;
+  const requestMethod = method.split("-")[0]?.toUpperCase() || "-";
+  const responseMethod = method.split("-")[1]?.toUpperCase() || requestMethod;
+  return console.log(
+    `
+`,
+    `[Next Server API] \u23F1 ${dateText} ( ${timeText} )`,
+    `
+  \u03BB [${requestMethod}] FE route`,
+    `
+   ${routeUrl}`,
+    ...queryUrl ? [`
+  \u2550\u23F5 \u03A9 [${responseMethod}] BE url`, `
+   ${queryUrl}`, `
+`] : [],
+    ...messages?.[0] ? [` \u25C7-`, ...messages] : [],
+    `
+`
+  );
+};
+var generateQueryUrl = ({
+  method = "GET",
+  domain,
+  routeUrl,
+  queryUrl,
+  searchParams,
+  log,
+  logDisabled
+}) => {
+  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;
+  if (!logDisabled) {
+    nextAPILog(method, routeUrl, url, {
+      ...log ?? {},
+      ...searchParams ?? {}
+    });
+  }
+  return url;
+};
+var getFetchOptions = ({
+  method,
+  headers: headers2,
+  body
+}) => {
+  const option = { method };
+  if (typeof headers2 !== "undefined" && headers2 && Object.keys(headers2).length > 0)
+    Object.assign(option, { headers: headers2 });
+  if (typeof body !== "undefined" && body) Object.assign(option, { body });
+  return option;
+};
 async function setTokenRequestHeaders(headerOptions) {
   const nextHeaders = await headers();
   const token = nextHeaders.get("Authorization") || "";
   if (!token) return void 0;
   return new Headers({
     Authorization: token,
+    // Bearer 포함됨
     ...headerOptions
   });
 }
+async function authorizedFetch({
+  method = "GET",
+  disabledToken,
+  urlOptions,
+  headers: headers2,
+  bodyData
+}) {
+  const { domain, routeUrl, queryUrl } = urlOptions;
+  if (!domain && !queryUrl) {
+    nextAPILog(method, routeUrl, "NO URL", {
+      ...urlOptions
+    });
+    return new Response("API \uB3C4\uBA54\uC778 \uB610\uB294 \uACBD\uB85C\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.", {
+      status: 500
+    });
+  }
+  const url = generateQueryUrl({ ...urlOptions, method });
+  nextAPILog(method, routeUrl, url, { ...urlOptions });
+  const headerOptions = {
+    // 외부에서 전달된 헤더
+    ...headers2,
+    // 백엔드 디버깅용 헤더 추가
+    "Uniai-Native-Domain-Env-Exist": String(!!domain),
+    "Uniai-Native-Domain": domain,
+    "Uniai-Native-Path": queryUrl
+  };
+  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,
+    headers: headerOptions,
+    headersWithToken: requestHeaders
+  });
+  if (!disabledToken && !requestHeaders) {
+    return new Response("\uC778\uC99D \uC815\uBCF4\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.", {
+      status: 401,
+      headers: headerOptions
+    });
+  }
+  const fetchOptions = {
+    method,
+    headers: requestHeaders
+  };
+  if (method !== "GET" && bodyData !== void 0) {
+    nextAPILog(method, routeUrl, url, { bodyData });
+    const stringifyData = convertObjectToSearchParams(bodyData).toString();
+    nextAPILog(method, routeUrl, url, { stringifyData });
+    if (stringifyData) {
+      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" });
+    }
+  }
+  nextAPILog(method, routeUrl, url, { fetchOptions });
+  return await fetch(url, getFetchOptions(fetchOptions));
+}
 async function setDebugResponseHeaders({
   res,
   domain,
@@ -26,7 +142,7 @@ async function setDebugResponseHeaders({
   response.headers.set("Uniai-Native-Domain-Env-Exist", String(!!domain));
   response.headers.set("Uniai-Native-Domain", domain);
   response.headers.set("Uniai-Native-Path", queryUrl);
-  const url = fullUrl || `${domain || ""}${queryUrl || ""}${queryString || searchParams ? getQueryString(searchParams) : ""}`;
+  const url = fullUrl || `${domain || ""}${queryUrl || ""}${typeof queryString === "string" ? queryString : getQueryString(searchParams)}`;
   response.headers.set("Uniai-Native-URL", url);
   return response;
 }
@@ -43,6 +159,6 @@ function setViewportDeviceInfo(response, userAgent) {
   return responseUpdate;
 }
 
-export { setDebugResponseHeaders, setTokenRequestHeaders, setViewportDeviceInfo };
+export { authorizedFetch, setDebugResponseHeaders, setTokenRequestHeaders, setViewportDeviceInfo };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server/module.ts","../src/runtime-env/module.ts"],"names":[],"mappings":";;;;;;AAgBA,eAAsB,uBACpB,aAAA,EACkC;AAClC,EAAA,MAAM,WAAA,GAAc,MAAM,OAAA,EAAQ;AAClC,EAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,GAAA,CAAI,eAAe,CAAA,IAAK,EAAA;AAClD,EAAA,IAAI,CAAC,OAAO,OAAO,MAAA;AACnB,EAAA,OAAO,IAAI,OAAA,CAAQ;AAAA,IACjB,aAAA,EAAe,KAAA;AAAA,IACf,GAAG;AAAA,GACJ,CAAA;AACH;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,QAAA,GAAW,YAAA,CAAa,IAAA,CAAK,GAAA,EAAK,OAAO,CAAA;AAE/C,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,WAAA,IAAe,YAAA,GAAe,cAAA,CAAe,YAAY,IAAI,EAAE,CAAA,CAAA;AACpG,EAAA,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,kBAAA,EAAoB,GAAG,CAAA;AAE5C,EAAA,OAAO,QAAA;AACT;AC3FO,SAAS,qBAAA,CACd,UACA,SAAA,EACc;AACd,EAAA,MAAM,cAAA,GAAiB,QAAA;AAGvB,EAAA,cAAA,CAAe,OAAA,CAAQ,GAAA;AAAA,IACrB,qBAAA;AAAA,IACA,sBAAsB,SAAS;AAAA,GACjC;AAGA,EAAA,cAAA,CAAe,OAAA,CAAQ,GAAA;AAAA,IACrB,gBAAA;AAAA,IACA,gBAAA,CAAiB,SAAS,CAAA,GAAI,MAAA,GAAS;AAAA,GACzC;AAEA,EAAA,OAAO,cAAA;AACT","file":"index.mjs","sourcesContent":["\"use server\";\n\nimport { headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport { getQueryString } from \"@uniai-fe/util-functions/api\";\n\n/**\n * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n *\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  const nextHeaders = await headers();\n  const token = nextHeaders.get(\"Authorization\") || \"\";\n  if (!token) return undefined;\n  return new Headers({\n    Authorization: token,\n    ...headerOptions,\n  });\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 response = NextResponse.json(res, options);\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 || \"\"}${queryString || searchParams ? 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  const option: RequestInit = { method };\n\n  // API fetch Headers\n  if (\n    typeof headers !== \"undefined\" &&\n    headers &&\n    Object.keys(headers).length > 0\n  )\n    Object.assign(option, { headers });\n\n  // API fetch Body\n  if (typeof body !== \"undefined\" && body) Object.assign(option, { body });\n\n  return option;\n};\n\n/**\n * API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit | null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\n */\nexport const fetchWithBody = async <\n  BodyDataType = object,\n  ResponseType extends object | Response = Response,\n>({\n  domain,\n  method,\n  routeUrl,\n  queryUrl,\n  searchParams,\n  headers,\n  body,\n  bodyData,\n  isRawResponse,\n  alternateResponse,\n  debug,\n  disabled,\n  disabledLog,\n}: API_FetchWithBodyParams<\n  BodyDataType,\n  ResponseType\n>): Promise<ResponseType> => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n  const option = getFetchOptions({ method, headers, body });\n\n  if (!body && typeof bodyData !== \"undefined\") {\n    // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n    const bodyParams = convertObjectToSearchParams(bodyData).toString();\n    if (bodyParams === \"\") {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (BODY - DATA)\",\n        error: \"데이터가 유효하지 않습니다.\",\n        bodyData,\n        ...(debug ?? {}),\n      });\n      return alternateResponse;\n    }\n    option.body = bodyData as BodyInit;\n  }\n\n  if (!disabledLog) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"READY\",\n      ...option,\n      ...(debug ?? {}),\n    });\n  }\n\n  if (disabled) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"FETCH DISABLED\",\n      message: \"API 요청제한 활성화됨.\",\n    });\n    return alternateResponse;\n  }\n\n  try {\n    const responseRaw = await fetch(url, option);\n    const responseCode = responseRaw.status;\n\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n        code: responseCode,\n      });\n    }\n\n    if (isRawResponse) {\n      return responseRaw as ResponseType;\n    }\n    return (await responseRaw.json()) as ResponseType;\n  } catch (error: unknown) {\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (RESPONSE)\",\n        error,\n        ...(debug ?? {}),\n      });\n    }\n    return alternateResponse;\n  }\n};\n","\"use server\";\n\nimport { 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  const nextHeaders = await headers();\n  const token = nextHeaders.get(\"Authorization\") || \"\";\n  if (!token) return undefined;\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    return new Response(\"API 도메인 또는 경로가 설정되지 않았습니다.\", {\n      status: 500,\n    });\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    headers: headerOptions,\n    headersWithToken: requestHeaders,\n  });\n\n  // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n  if (!disabledToken && !requestHeaders) {\n    return new Response(\"인증 정보를 확인할 수 없습니다.\", {\n      status: 401,\n      headers: headerOptions,\n    });\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, { fetchOptions });\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 response = NextResponse.json(res, options);\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

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/server/index.ts
 var server_exports = {};
 __export(server_exports, {
+  authorizedFetch: () => authorizedFetch,
   setDebugResponseHeaders: () => setDebugResponseHeaders,
   setTokenRequestHeaders: () => setTokenRequestHeaders
 });
@@ -28,16 +29,138 @@ module.exports = __toCommonJS(server_exports);
 // src/server/module.ts
 var import_headers = require("next/headers");
 var import_server = require("next/server");
-var import_api = require("@uniai-fe/util-functions/api");
+
+// ../api/dist/index.mjs
+var import_util_functions = require("@uniai-fe/util-functions");
+var getQueryString = (searchParams) => {
+  const serialized = (0, import_util_functions.convertObjectToSearchParams)(searchParams).toString();
+  return serialized ? `?${serialized}` : "";
+};
+var nextAPILog = (method, routeUrl, queryUrl, ...messages) => {
+  const date = /* @__PURE__ */ new Date();
+  const dateText = date.toISOString().split("T")[0] ?? "";
+  const timeText = `${date.toLocaleTimeString("en-US", { hour12: false })}.${date.getMilliseconds()}`;
+  const requestMethod = method.split("-")[0]?.toUpperCase() || "-";
+  const responseMethod = method.split("-")[1]?.toUpperCase() || requestMethod;
+  return console.log(
+    `
+`,
+    `[Next Server API] \u23F1 ${dateText} ( ${timeText} )`,
+    `
+  \u03BB [${requestMethod}] FE route`,
+    `
+   ${routeUrl}`,
+    ...queryUrl ? [`
+  \u2550\u23F5 \u03A9 [${responseMethod}] BE url`, `
+   ${queryUrl}`, `
+`] : [],
+    ...messages?.[0] ? [` \u25C7-`, ...messages] : [],
+    `
+`
+  );
+};
+var generateQueryUrl = ({
+  method = "GET",
+  domain,
+  routeUrl,
+  queryUrl,
+  searchParams,
+  log,
+  logDisabled
+}) => {
+  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;
+  if (!logDisabled) {
+    nextAPILog(method, routeUrl, url, {
+      ...log ?? {},
+      ...searchParams ?? {}
+    });
+  }
+  return url;
+};
+var getFetchOptions = ({
+  method,
+  headers: headers2,
+  body
+}) => {
+  const option = { method };
+  if (typeof headers2 !== "undefined" && headers2 && Object.keys(headers2).length > 0)
+    Object.assign(option, { headers: headers2 });
+  if (typeof body !== "undefined" && body) Object.assign(option, { body });
+  return option;
+};
+
+// src/server/module.ts
+var import_util_functions2 = require("@uniai-fe/util-functions");
 async function setTokenRequestHeaders(headerOptions) {
   const nextHeaders = await (0, import_headers.headers)();
   const token = nextHeaders.get("Authorization") || "";
   if (!token) return void 0;
   return new Headers({
     Authorization: token,
+    // Bearer 포함됨
     ...headerOptions
   });
 }
+async function authorizedFetch({
+  method = "GET",
+  disabledToken,
+  urlOptions,
+  headers: headers2,
+  bodyData
+}) {
+  const { domain, routeUrl, queryUrl } = urlOptions;
+  if (!domain && !queryUrl) {
+    nextAPILog(method, routeUrl, "NO URL", {
+      ...urlOptions
+    });
+    return new Response("API \uB3C4\uBA54\uC778 \uB610\uB294 \uACBD\uB85C\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.", {
+      status: 500
+    });
+  }
+  const url = generateQueryUrl({ ...urlOptions, method });
+  nextAPILog(method, routeUrl, url, { ...urlOptions });
+  const headerOptions = {
+    // 외부에서 전달된 헤더
+    ...headers2,
+    // 백엔드 디버깅용 헤더 추가
+    "Uniai-Native-Domain-Env-Exist": String(!!domain),
+    "Uniai-Native-Domain": domain,
+    "Uniai-Native-Path": queryUrl
+  };
+  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,
+    headers: headerOptions,
+    headersWithToken: requestHeaders
+  });
+  if (!disabledToken && !requestHeaders) {
+    return new Response("\uC778\uC99D \uC815\uBCF4\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.", {
+      status: 401,
+      headers: headerOptions
+    });
+  }
+  const fetchOptions = {
+    method,
+    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 (stringifyData) {
+      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" });
+    }
+  }
+  nextAPILog(method, routeUrl, url, { fetchOptions });
+  return await fetch(url, getFetchOptions(fetchOptions));
+}
 async function setDebugResponseHeaders({
   res,
   domain,
@@ -51,12 +174,13 @@ async function setDebugResponseHeaders({
   response.headers.set("Uniai-Native-Domain-Env-Exist", String(!!domain));
   response.headers.set("Uniai-Native-Domain", domain);
   response.headers.set("Uniai-Native-Path", queryUrl);
-  const url = fullUrl || `${domain || ""}${queryUrl || ""}${queryString || searchParams ? (0, import_api.getQueryString)(searchParams) : ""}`;
+  const url = fullUrl || `${domain || ""}${queryUrl || ""}${typeof queryString === "string" ? queryString : getQueryString(searchParams)}`;
   response.headers.set("Uniai-Native-URL", url);
   return response;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  authorizedFetch,
   setDebugResponseHeaders,
   setTokenRequestHeaders
 });

package/dist/server/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/index.ts","../../src/server/module.ts"],"sourcesContent":["export * from \"./module\";\n","\"use server\";\n\nimport { headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport { getQueryString } from \"@uniai-fe/util-functions/api\";\n\n/**\n * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n *\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  const nextHeaders = await headers();\n  const token = nextHeaders.get(\"Authorization\") || \"\";\n  if (!token) return undefined;\n  return new Headers({\n    Authorization: token,\n    ...headerOptions,\n  });\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 response = NextResponse.json(res, options);\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 || \"\"}${queryString || searchParams ? getQueryString(searchParams) : \"\"}`;\n  response.headers.set(\"Uniai-Native-URL\", url);\n\n  return response;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,qBAAwB;AACxB,oBAA6B;AAC7B,iBAA+B;AAY/B,eAAsB,uBACpB,eACkC;AAClC,QAAM,cAAc,UAAM,wBAAQ;AAClC,QAAM,QAAQ,YAAY,IAAI,eAAe,KAAK;AAClD,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,IAAI,QAAQ;AAAA,IACjB,eAAe;AAAA,IACf,GAAG;AAAA,EACL,CAAC;AACH;AAqBA,eAAsB,wBAAsC;AAAA,EAC1D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAgCyC;AACvC,QAAM,WAAW,2BAAa,KAAK,KAAK,OAAO;AAE/C,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,eAAe,mBAAe,2BAAe,YAAY,IAAI,EAAE;AACpG,WAAS,QAAQ,IAAI,oBAAoB,GAAG;AAE5C,SAAO;AACT;","names":[]}
+{"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 { 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  const nextHeaders = await headers();\n  const token = nextHeaders.get(\"Authorization\") || \"\";\n  if (!token) return undefined;\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    return new Response(\"API 도메인 또는 경로가 설정되지 않았습니다.\", {\n      status: 500,\n    });\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    headers: headerOptions,\n    headersWithToken: requestHeaders,\n  });\n\n  // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n  if (!disabledToken && !requestHeaders) {\n    return new Response(\"인증 정보를 확인할 수 없습니다.\", {\n      status: 401,\n      headers: headerOptions,\n    });\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, { fetchOptions });\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 response = NextResponse.json(res, options);\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  const option: RequestInit = { method };\n\n  // API fetch Headers\n  if (\n    typeof headers !== \"undefined\" &&\n    headers &&\n    Object.keys(headers).length > 0\n  )\n    Object.assign(option, { headers });\n\n  // API fetch Body\n  if (typeof body !== \"undefined\" && body) Object.assign(option, { body });\n\n  return option;\n};\n\n/**\n * API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit | null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\n */\nexport const fetchWithBody = async <\n  BodyDataType = object,\n  ResponseType extends object | Response = Response,\n>({\n  domain,\n  method,\n  routeUrl,\n  queryUrl,\n  searchParams,\n  headers,\n  body,\n  bodyData,\n  isRawResponse,\n  alternateResponse,\n  debug,\n  disabled,\n  disabledLog,\n}: API_FetchWithBodyParams<\n  BodyDataType,\n  ResponseType\n>): Promise<ResponseType> => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n  const option = getFetchOptions({ method, headers, body });\n\n  if (!body && typeof bodyData !== \"undefined\") {\n    // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n    const bodyParams = convertObjectToSearchParams(bodyData).toString();\n    if (bodyParams === \"\") {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (BODY - DATA)\",\n        error: \"데이터가 유효하지 않습니다.\",\n        bodyData,\n        ...(debug ?? {}),\n      });\n      return alternateResponse;\n    }\n    option.body = bodyData as BodyInit;\n  }\n\n  if (!disabledLog) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"READY\",\n      ...option,\n      ...(debug ?? {}),\n    });\n  }\n\n  if (disabled) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"FETCH DISABLED\",\n      message: \"API 요청제한 활성화됨.\",\n    });\n    return alternateResponse;\n  }\n\n  try {\n    const responseRaw = await fetch(url, option);\n    const responseCode = responseRaw.status;\n\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n        code: responseCode,\n      });\n    }\n\n    if (isRawResponse) {\n      return responseRaw as ResponseType;\n    }\n    return (await responseRaw.json()) as ResponseType;\n  } catch (error: unknown) {\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (RESPONSE)\",\n        error,\n        ...(debug ?? {}),\n      });\n    }\n    return alternateResponse;\n  }\n};\n"],"mappings":"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","names":["headers","import_util_functions","headers"]}

package/dist/server/index.d.cts

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

package/dist/server/index.d.ts

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

package/dist/server/index.mjs

@@ -1,16 +1,138 @@
 // src/server/module.ts
 import { headers } from "next/headers";
 import { NextResponse } from "next/server";
-import { getQueryString } from "@uniai-fe/util-functions/api";
+
+// ../api/dist/index.mjs
+import { convertObjectToSearchParams } from "@uniai-fe/util-functions";
+var getQueryString = (searchParams) => {
+  const serialized = convertObjectToSearchParams(searchParams).toString();
+  return serialized ? `?${serialized}` : "";
+};
+var nextAPILog = (method, routeUrl, queryUrl, ...messages) => {
+  const date = /* @__PURE__ */ new Date();
+  const dateText = date.toISOString().split("T")[0] ?? "";
+  const timeText = `${date.toLocaleTimeString("en-US", { hour12: false })}.${date.getMilliseconds()}`;
+  const requestMethod = method.split("-")[0]?.toUpperCase() || "-";
+  const responseMethod = method.split("-")[1]?.toUpperCase() || requestMethod;
+  return console.log(
+    `
+`,
+    `[Next Server API] \u23F1 ${dateText} ( ${timeText} )`,
+    `
+  \u03BB [${requestMethod}] FE route`,
+    `
+   ${routeUrl}`,
+    ...queryUrl ? [`
+  \u2550\u23F5 \u03A9 [${responseMethod}] BE url`, `
+   ${queryUrl}`, `
+`] : [],
+    ...messages?.[0] ? [` \u25C7-`, ...messages] : [],
+    `
+`
+  );
+};
+var generateQueryUrl = ({
+  method = "GET",
+  domain,
+  routeUrl,
+  queryUrl,
+  searchParams,
+  log,
+  logDisabled
+}) => {
+  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;
+  if (!logDisabled) {
+    nextAPILog(method, routeUrl, url, {
+      ...log ?? {},
+      ...searchParams ?? {}
+    });
+  }
+  return url;
+};
+var getFetchOptions = ({
+  method,
+  headers: headers2,
+  body
+}) => {
+  const option = { method };
+  if (typeof headers2 !== "undefined" && headers2 && Object.keys(headers2).length > 0)
+    Object.assign(option, { headers: headers2 });
+  if (typeof body !== "undefined" && body) Object.assign(option, { body });
+  return option;
+};
+
+// src/server/module.ts
+import { convertObjectToSearchParams as convertObjectToSearchParams2 } from "@uniai-fe/util-functions";
 async function setTokenRequestHeaders(headerOptions) {
   const nextHeaders = await headers();
   const token = nextHeaders.get("Authorization") || "";
   if (!token) return void 0;
   return new Headers({
     Authorization: token,
+    // Bearer 포함됨
     ...headerOptions
   });
 }
+async function authorizedFetch({
+  method = "GET",
+  disabledToken,
+  urlOptions,
+  headers: headers2,
+  bodyData
+}) {
+  const { domain, routeUrl, queryUrl } = urlOptions;
+  if (!domain && !queryUrl) {
+    nextAPILog(method, routeUrl, "NO URL", {
+      ...urlOptions
+    });
+    return new Response("API \uB3C4\uBA54\uC778 \uB610\uB294 \uACBD\uB85C\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.", {
+      status: 500
+    });
+  }
+  const url = generateQueryUrl({ ...urlOptions, method });
+  nextAPILog(method, routeUrl, url, { ...urlOptions });
+  const headerOptions = {
+    // 외부에서 전달된 헤더
+    ...headers2,
+    // 백엔드 디버깅용 헤더 추가
+    "Uniai-Native-Domain-Env-Exist": String(!!domain),
+    "Uniai-Native-Domain": domain,
+    "Uniai-Native-Path": queryUrl
+  };
+  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,
+    headers: headerOptions,
+    headersWithToken: requestHeaders
+  });
+  if (!disabledToken && !requestHeaders) {
+    return new Response("\uC778\uC99D \uC815\uBCF4\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.", {
+      status: 401,
+      headers: headerOptions
+    });
+  }
+  const fetchOptions = {
+    method,
+    headers: requestHeaders
+  };
+  if (method !== "GET" && bodyData !== void 0) {
+    nextAPILog(method, routeUrl, url, { bodyData });
+    const stringifyData = convertObjectToSearchParams2(bodyData).toString();
+    nextAPILog(method, routeUrl, url, { stringifyData });
+    if (stringifyData) {
+      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" });
+    }
+  }
+  nextAPILog(method, routeUrl, url, { fetchOptions });
+  return await fetch(url, getFetchOptions(fetchOptions));
+}
 async function setDebugResponseHeaders({
   res,
   domain,
@@ -24,11 +146,12 @@ async function setDebugResponseHeaders({
   response.headers.set("Uniai-Native-Domain-Env-Exist", String(!!domain));
   response.headers.set("Uniai-Native-Domain", domain);
   response.headers.set("Uniai-Native-Path", queryUrl);
-  const url = fullUrl || `${domain || ""}${queryUrl || ""}${queryString || searchParams ? getQueryString(searchParams) : ""}`;
+  const url = fullUrl || `${domain || ""}${queryUrl || ""}${typeof queryString === "string" ? queryString : getQueryString(searchParams)}`;
   response.headers.set("Uniai-Native-URL", url);
   return response;
 }
 export {
+  authorizedFetch,
   setDebugResponseHeaders,
   setTokenRequestHeaders
 };

package/dist/server/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/module.ts"],"sourcesContent":["\"use server\";\n\nimport { headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport { getQueryString } from \"@uniai-fe/util-functions/api\";\n\n/**\n * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n *\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  const nextHeaders = await headers();\n  const token = nextHeaders.get(\"Authorization\") || \"\";\n  if (!token) return undefined;\n  return new Headers({\n    Authorization: token,\n    ...headerOptions,\n  });\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 response = NextResponse.json(res, options);\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 || \"\"}${queryString || searchParams ? getQueryString(searchParams) : \"\"}`;\n  response.headers.set(\"Uniai-Native-URL\", url);\n\n  return response;\n}\n"],"mappings":";AAEA,SAAS,eAAe;AACxB,SAAS,oBAAoB;AAC7B,SAAS,sBAAsB;AAY/B,eAAsB,uBACpB,eACkC;AAClC,QAAM,cAAc,MAAM,QAAQ;AAClC,QAAM,QAAQ,YAAY,IAAI,eAAe,KAAK;AAClD,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,IAAI,QAAQ;AAAA,IACjB,eAAe;AAAA,IACf,GAAG;AAAA,EACL,CAAC;AACH;AAqBA,eAAsB,wBAAsC;AAAA,EAC1D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAgCyC;AACvC,QAAM,WAAW,aAAa,KAAK,KAAK,OAAO;AAE/C,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,eAAe,eAAe,eAAe,YAAY,IAAI,EAAE;AACpG,WAAS,QAAQ,IAAI,oBAAoB,GAAG;AAE5C,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/server/module.ts","../../../api/src/response/module.ts","../../../api/src/request/module.ts"],"sourcesContent":["\"use server\";\n\nimport { 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  const nextHeaders = await headers();\n  const token = nextHeaders.get(\"Authorization\") || \"\";\n  if (!token) return undefined;\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    return new Response(\"API 도메인 또는 경로가 설정되지 않았습니다.\", {\n      status: 500,\n    });\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    headers: headerOptions,\n    headersWithToken: requestHeaders,\n  });\n\n  // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n  if (!disabledToken && !requestHeaders) {\n    return new Response(\"인증 정보를 확인할 수 없습니다.\", {\n      status: 401,\n      headers: headerOptions,\n    });\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, { fetchOptions });\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 response = NextResponse.json(res, options);\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  const option: RequestInit = { method };\n\n  // API fetch Headers\n  if (\n    typeof headers !== \"undefined\" &&\n    headers &&\n    Object.keys(headers).length > 0\n  )\n    Object.assign(option, { headers });\n\n  // API fetch Body\n  if (typeof body !== \"undefined\" && body) Object.assign(option, { body });\n\n  return option;\n};\n\n/**\n * API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit | null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\n */\nexport const fetchWithBody = async <\n  BodyDataType = object,\n  ResponseType extends object | Response = Response,\n>({\n  domain,\n  method,\n  routeUrl,\n  queryUrl,\n  searchParams,\n  headers,\n  body,\n  bodyData,\n  isRawResponse,\n  alternateResponse,\n  debug,\n  disabled,\n  disabledLog,\n}: API_FetchWithBodyParams<\n  BodyDataType,\n  ResponseType\n>): Promise<ResponseType> => {\n  const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n  const option = getFetchOptions({ method, headers, body });\n\n  if (!body && typeof bodyData !== \"undefined\") {\n    // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n    const bodyParams = convertObjectToSearchParams(bodyData).toString();\n    if (bodyParams === \"\") {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (BODY - DATA)\",\n        error: \"데이터가 유효하지 않습니다.\",\n        bodyData,\n        ...(debug ?? {}),\n      });\n      return alternateResponse;\n    }\n    option.body = bodyData as BodyInit;\n  }\n\n  if (!disabledLog) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"READY\",\n      ...option,\n      ...(debug ?? {}),\n    });\n  }\n\n  if (disabled) {\n    nextAPILog(method.toLowerCase(), routeUrl, url, {\n      state: \"FETCH DISABLED\",\n      message: \"API 요청제한 활성화됨.\",\n    });\n    return alternateResponse;\n  }\n\n  try {\n    const responseRaw = await fetch(url, option);\n    const responseCode = responseRaw.status;\n\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n        code: responseCode,\n      });\n    }\n\n    if (isRawResponse) {\n      return responseRaw as ResponseType;\n    }\n    return (await responseRaw.json()) as ResponseType;\n  } catch (error: unknown) {\n    if (!disabledLog) {\n      nextAPILog(method.toLowerCase(), routeUrl, url, {\n        state: \"ERROR (RESPONSE)\",\n        error,\n        ...(debug ?? {}),\n      });\n    }\n    return alternateResponse;\n  }\n};\n"],"mappings":"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","names":["headers","convertObjectToSearchParams","headers"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniai-fe/util-next",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "Next.js Utilities for UNIAI FE Projects",
   "type": "module",
   "private": false,
@@ -10,7 +10,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "packageManager": "pnpm@10.28.2",
+  "packageManager": "pnpm@10.32.1",
   "engines": {
     "node": ">=24",
     "pnpm": ">=10"
@@ -69,6 +69,7 @@
     "@uniai-fe/eslint-config": "workspace:*",
     "@uniai-fe/tsconfig": "workspace:*",
     "@uniai-fe/util-functions": "workspace:*",
+    "@uniai-fe/util-api": "workspace:*",
     "eslint": "^9.39.2",
     "prettier": "^3.8.1",
     "tsup": "^8.5.1",