npm - @uniai-fe/util-next - Versions diffs - 0.2.13 → 0.2.14 - Mend

@uniai-fe/util-next 0.2.13 → 0.2.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/dist/index.cjs CHANGED Viewed

@@ -134,7 +134,10 @@ async function authorizedFetch({
   };
   if (method !== "GET" && bodyData !== void 0) {
     if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });
-    const stringifyData = utilFunctions.convertObjectToSearchParams(bodyData).toString();
+    const stringifyData = utilFunctions.convertObjectToSearchParams(bodyData, {
+      method,
+      urlOptions
+    }).toString();
     if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });
     if (stringifyData) {
       if (!disabledLog)

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../api/src/request/module.ts","../src/server/module.ts","../src/runtime-env/module.ts"],"names":["convertObjectToSearchParams","headers","cookies","NextResponse","checkResponsiveDevice","checkAppleDevice"],"mappings":"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","file":"index.cjs","sourcesContent":["import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n API_FetchWithBodyParams,\n API_GetFetchOptionsParams,\n API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/*\n API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n /\nexport const getQueryString = (searchParams?: unknown): string => {\n // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n const serialized = convertObjectToSearchParams(searchParams).toString();\n return serialized ? `?${serialized}` : \"\";\n};\n\n/\n API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query URL\n * @param {unknown[]} messages 로그 메시지\n /\nexport const nextAPILog = (\n method: string,\n routeUrl: string,\n queryUrl?: string,\n ...messages: unknown[]\n) => {\n // 2026-03-19: 배포 환경에서의 모니터링 및 디버깅을 위한 서버 로그 확인을 위해 주석처리함\n // if (process.env.NODE_ENV === \"production\") {\n // return;\n // }\n\n // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n const date = new Date();\n const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n const requestMethod = method.split(\"-\")[0]?.toUpperCase() \|\| \"-\";\n const responseMethod = method.split(\"-\")[1]?.toUpperCase() \|\| requestMethod;\n\n return console.log(\n `\\n`,\n `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n `\\n λ [${requestMethod}] FE route`,\n `\\n ${routeUrl}`,\n ...(queryUrl\n ? [`\\n ═⏵ Ω [${responseMethod}] BE url`, `\\n ${queryUrl}`, `\\n`]\n : []),\n ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n `\\n`,\n );\n};\n\n/\n API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams \| object} [searchParams] 쿼리스트링 원본\n /\nexport const getRouteUrl = (\n routeUrl: string,\n searchParams?: URLSearchParams \| object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/\n API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n /\nexport const generateQueryUrl = ({\n method = \"GET\",\n domain,\n routeUrl,\n queryUrl,\n searchParams,\n log,\n logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n if (!logDisabled) {\n nextAPILog(method, routeUrl, url, {\n ...(log ?? {}),\n ...(searchParams ?? {}),\n });\n }\n\n return url;\n};\n\n/\n API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit \| null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n * method: \"POST\",\n * headers: { \"Content-Type\": \"application/json\" },\n * body: JSON.stringify({ farm_id: 1 }),\n * });\n /\nexport const getFetchOptions = ({\n method,\n headers,\n body,\n}: API_GetFetchOptionsParams): RequestInit => ({\n method,\n // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\n ...(typeof headers === \"undefined\" ? {} : { headers }),\n ...(typeof body === \"undefined\" ? {} : { body }),\n});\n\n/\n API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit \| null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\n /\nexport const fetchWithBody = async <\n BodyDataType = object,\n ResponseType extends object \| Response = Response,\n>({\n domain,\n method,\n routeUrl,\n queryUrl,\n searchParams,\n headers,\n body,\n bodyData,\n isRawResponse,\n alternateResponse,\n debug,\n disabled,\n disabledLog,\n}: API_FetchWithBodyParams<\n BodyDataType,\n ResponseType\n>): Promise<ResponseType> => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n const option = getFetchOptions({ method, headers, body });\n\n if (!body && typeof bodyData !== \"undefined\") {\n // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n const bodyParams = convertObjectToSearchParams(bodyData).toString();\n if (bodyParams === \"\") {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (BODY - DATA)\",\n error: \"데이터가 유효하지 않습니다.\",\n bodyData,\n ...(debug ?? {}),\n });\n return alternateResponse;\n }\n option.body = bodyData as BodyInit;\n }\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"READY\",\n ...option,\n ...(debug ?? {}),\n });\n }\n\n if (disabled) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"FETCH DISABLED\",\n message: \"API 요청제한 활성화됨.\",\n });\n return alternateResponse;\n }\n\n try {\n const responseRaw = await fetch(url, option);\n const responseCode = responseRaw.status;\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n code: responseCode,\n });\n }\n\n if (isRawResponse) {\n return responseRaw as ResponseType;\n }\n return (await responseRaw.json()) as ResponseType;\n } catch (error: unknown) {\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (RESPONSE)\",\n error,\n ...(debug ?? {}),\n });\n }\n return alternateResponse;\n }\n};\n","\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n generateQueryUrl,\n getFetchOptions,\n getQueryString,\n nextAPILog,\n type API_GenerateQueryUrlParams,\n type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/\n 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)\n * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n \n @returns {Promise<HeadersInit \| undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n /\nexport async function setTokenRequestHeaders(\n headerOptions?: HeadersInit,\n disabledLog: boolean = true,\n): Promise<HeadersInit \| undefined> {\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] headerOptions:\",\n Object.fromEntries(new Headers(headerOptions)),\n );\n const nextHeaders = await headers();\n const headerToken = nextHeaders.get(\"Authorization\") \|\| \"\";\n const cookieToken = (await cookies()).get(\"token\")?.value \|\| \"\";\n\n if (!disabledLog)\n console.log(\"[setTokenRequestHeaders] token:\", {\n headers: headerToken,\n cookie: cookieToken,\n });\n // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n const token = headerToken \|\| (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n if (!disabledLog) console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n if (!token) return undefined;\n\n const res = new Headers({\n Authorization: token, // Bearer 포함됨\n ...headerOptions,\n });\n\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] final headers:\",\n Object.fromEntries(res),\n );\n\n return res;\n}\n\n/\n 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)\n * @returns {Promise<Response>} fetch 응답 객체\n /\nexport async function authorizedFetch({\n method = \"GET\",\n disabledToken,\n urlOptions,\n headers,\n bodyData,\n disabledLog,\n}: {\n method?: string;\n disabledToken?: boolean;\n urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n headers?: HeadersInit;\n bodyData?: object;\n disabledLog?: boolean;\n}): Promise<Response> {\n const { domain, routeUrl, queryUrl } = urlOptions;\n\n // 기초 데이터 검증\n if (!domain && !queryUrl) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, \"NO URL\", {\n ...urlOptions,\n });\n\n // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n }\n\n // -------------------------- url 구성; start\n\n // 백엔드 요청 URL\n const url = generateQueryUrl({ ...urlOptions, method });\n if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n // -------------------------- url 구성; end\n\n // -------------------------- debug headers 구성; start\n\n const headerOptions: HeadersInit = {\n // 외부에서 전달된 헤더\n ...headers,\n // 백엔드 디버깅용 헤더 추가\n \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n \"Uniai-Native-Domain\": domain,\n \"Uniai-Native-Path\": queryUrl,\n };\n\n // 백엔드 요청 URL 전체\n const nativeUrl = `${domain \|\| \"\"}${queryUrl \|\| \"\"}${getQueryString(urlOptions.searchParams)}`;\n Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n // -------------------------- debug headers 구성; end\n\n // -------------------------- authorization token 구성; start\n\n // 인증 토큰 추가\n // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n const requestHeaders = disabledToken\n ? new Headers(headerOptions)\n : await setTokenRequestHeaders(headerOptions);\n\n if (!disabledLog) {\n nextAPILog(method, routeUrl, url, {\n disabledToken,\n headers: headerOptions,\n headerWithToken: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n });\n }\n\n // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n if (!disabledToken && !requestHeaders) {\n // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n }\n\n // -------------------------- authorization token 구성; end\n\n // -------------------------- fetch options 구성; start\n\n const fetchOptions: API_GetFetchOptionsParams = {\n method,\n headers: requestHeaders,\n };\n\n // body 데이터 구성\n if (method !== \"GET\" && bodyData !== undefined) {\n if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });\n\n const stringifyData = convertObjectToSearchParams(bodyData).toString();\n if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });\n\n if (stringifyData) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n Object.assign(fetchOptions, {\n body: [\"string\", \"number\"].includes(typeof bodyData)\n ? String(bodyData)\n : JSON.stringify(bodyData),\n });\n } else {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n }\n }\n\n // -------------------------- fetch options 구성; end\n\n // -------------------------- fetch 실행; start\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, {\n fetchOptions: {\n ...fetchOptions,\n headers: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n },\n });\n return await fetch(url, getFetchOptions(fetchOptions));\n // -------------------------- fetch 실행; end\n}\n\n/\n 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams \| object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n /\nexport async function setDebugResponseHeaders<ResponseData>({\n res,\n domain,\n queryUrl,\n queryString,\n searchParams,\n fullUrl,\n options,\n}: {\n /\n fetch 응답 데이터\n /\n res: ResponseData;\n /\n API 도메인\n * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n /\n domain: string;\n /\n API 엔드포인트 쿼리 path\n /\n queryUrl: string;\n} & Partial<{\n /\n 쿼리스트링\n /\n queryString: string;\n /\n URLSearchParams 객체\n /\n searchParams: URLSearchParams \| object;\n /\n 전체 URL\n /\n fullUrl: string;\n /\n 응답 옵션\n /\n options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n const hasInvalidStatusText =\n typeof options?.statusText === \"string\" &&\n Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n const response = NextResponse.json(\n res,\n hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n );\n\n response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n response.headers.set(\"Uniai-Native-Domain\", domain);\n response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n const url =\n fullUrl \|\|\n `${domain \|\| \"\"}${queryUrl \|\| \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n response.headers.set(\"Uniai-Native-URL\", url);\n\n return response;\n}\n","import type { NextResponse } from \"next/server\";\nimport {\n checkResponsiveDevice,\n checkAppleDevice,\n} from \"@uniai-fe/util-functions\";\n\n/\n 감지된 기기 환경 저장\n */\nexport function setViewportDeviceInfo(\n response: NextResponse,\n userAgent: string,\n): NextResponse {\n const responseUpdate = response;\n\n // 접속 디바이스의 브레이크 포인트 체크\n responseUpdate.headers.set(\n \"X-Responsive-Device\",\n checkResponsiveDevice(userAgent),\n );\n\n // 접속 디바이스의 애플 기기 여부 체크\n responseUpdate.headers.set(\n \"X-Apple-Device\",\n checkAppleDevice(userAgent) ? \"true\" : \"false\",\n );\n\n return responseUpdate;\n}\n"]}
1	+ {"version":3,"sources":["../../api/src/request/module.ts","../src/server/module.ts","../src/runtime-env/module.ts"],"names":["convertObjectToSearchParams","headers","cookies","NextResponse","checkResponsiveDevice","checkAppleDevice"],"mappings":"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","file":"index.cjs","sourcesContent":["import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n API_FetchWithBodyParams,\n API_GetFetchOptionsParams,\n API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/*\n API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n /\nexport const getQueryString = (searchParams?: unknown): string => {\n // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n const serialized = convertObjectToSearchParams(searchParams).toString();\n return serialized ? `?${serialized}` : \"\";\n};\n\n/\n API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query URL\n * @param {unknown[]} messages 로그 메시지\n /\nexport const nextAPILog = (\n method: string,\n routeUrl: string,\n queryUrl?: string,\n ...messages: unknown[]\n) => {\n // 2026-03-19: 배포 환경에서의 모니터링 및 디버깅을 위한 서버 로그 확인을 위해 주석처리함\n // if (process.env.NODE_ENV === \"production\") {\n // return;\n // }\n\n // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n const date = new Date();\n const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n const requestMethod = method.split(\"-\")[0]?.toUpperCase() \|\| \"-\";\n const responseMethod = method.split(\"-\")[1]?.toUpperCase() \|\| requestMethod;\n\n return console.log(\n `\\n`,\n `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n `\\n λ [${requestMethod}] FE route`,\n `\\n ${routeUrl}`,\n ...(queryUrl\n ? [`\\n ═⏵ Ω [${responseMethod}] BE url`, `\\n ${queryUrl}`, `\\n`]\n : []),\n ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n `\\n`,\n );\n};\n\n/\n API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams \| object} [searchParams] 쿼리스트링 원본\n /\nexport const getRouteUrl = (\n routeUrl: string,\n searchParams?: URLSearchParams \| object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/\n API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n /\nexport const generateQueryUrl = ({\n method = \"GET\",\n domain,\n routeUrl,\n queryUrl,\n searchParams,\n log,\n logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n if (!logDisabled) {\n nextAPILog(method, routeUrl, url, {\n ...(log ?? {}),\n ...(searchParams ?? {}),\n });\n }\n\n return url;\n};\n\n/\n API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit \| null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n * method: \"POST\",\n * headers: { \"Content-Type\": \"application/json\" },\n * body: JSON.stringify({ farm_id: 1 }),\n * });\n /\nexport const getFetchOptions = ({\n method,\n headers,\n body,\n}: API_GetFetchOptionsParams): RequestInit => ({\n method,\n // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\n ...(typeof headers === \"undefined\" ? {} : { headers }),\n ...(typeof body === \"undefined\" ? {} : { body }),\n});\n\n/\n API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit \| null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\n /\nexport const fetchWithBody = async <\n BodyDataType = object,\n ResponseType extends object \| Response = Response,\n>({\n domain,\n method,\n routeUrl,\n queryUrl,\n searchParams,\n headers,\n body,\n bodyData,\n isRawResponse,\n alternateResponse,\n debug,\n disabled,\n disabledLog,\n}: API_FetchWithBodyParams<\n BodyDataType,\n ResponseType\n>): Promise<ResponseType> => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n const option = getFetchOptions({ method, headers, body });\n\n if (!body && typeof bodyData !== \"undefined\") {\n // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n const bodyParams = convertObjectToSearchParams(bodyData).toString();\n if (bodyParams === \"\") {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (BODY - DATA)\",\n error: \"데이터가 유효하지 않습니다.\",\n bodyData,\n ...(debug ?? {}),\n });\n return alternateResponse;\n }\n option.body = bodyData as BodyInit;\n }\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"READY\",\n ...option,\n ...(debug ?? {}),\n });\n }\n\n if (disabled) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"FETCH DISABLED\",\n message: \"API 요청제한 활성화됨.\",\n });\n return alternateResponse;\n }\n\n try {\n const responseRaw = await fetch(url, option);\n const responseCode = responseRaw.status;\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n code: responseCode,\n });\n }\n\n if (isRawResponse) {\n return responseRaw as ResponseType;\n }\n return (await responseRaw.json()) as ResponseType;\n } catch (error: unknown) {\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (RESPONSE)\",\n error,\n ...(debug ?? {}),\n });\n }\n return alternateResponse;\n }\n};\n","\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n generateQueryUrl,\n getFetchOptions,\n getQueryString,\n nextAPILog,\n type API_GenerateQueryUrlParams,\n type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/\n 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)\n * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n \n @returns {Promise<HeadersInit \| undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n /\nexport async function setTokenRequestHeaders(\n headerOptions?: HeadersInit,\n disabledLog: boolean = true,\n): Promise<HeadersInit \| undefined> {\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] headerOptions:\",\n Object.fromEntries(new Headers(headerOptions)),\n );\n const nextHeaders = await headers();\n const headerToken = nextHeaders.get(\"Authorization\") \|\| \"\";\n const cookieToken = (await cookies()).get(\"token\")?.value \|\| \"\";\n\n if (!disabledLog)\n console.log(\"[setTokenRequestHeaders] token:\", {\n headers: headerToken,\n cookie: cookieToken,\n });\n // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n const token = headerToken \|\| (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n if (!disabledLog) console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n if (!token) return undefined;\n\n const res = new Headers({\n Authorization: token, // Bearer 포함됨\n ...headerOptions,\n });\n\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] final headers:\",\n Object.fromEntries(res),\n );\n\n return res;\n}\n\n/\n 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)\n * @returns {Promise<Response>} fetch 응답 객체\n /\nexport async function authorizedFetch({\n method = \"GET\",\n disabledToken,\n urlOptions,\n headers,\n bodyData,\n disabledLog,\n}: {\n method?: string;\n disabledToken?: boolean;\n urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n headers?: HeadersInit;\n bodyData?: object;\n disabledLog?: boolean;\n}): Promise<Response> {\n const { domain, routeUrl, queryUrl } = urlOptions;\n\n // 기초 데이터 검증\n if (!domain && !queryUrl) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, \"NO URL\", {\n ...urlOptions,\n });\n\n // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n }\n\n // -------------------------- url 구성; start\n\n // 백엔드 요청 URL\n const url = generateQueryUrl({ ...urlOptions, method });\n if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n // -------------------------- url 구성; end\n\n // -------------------------- debug headers 구성; start\n\n const headerOptions: HeadersInit = {\n // 외부에서 전달된 헤더\n ...headers,\n // 백엔드 디버깅용 헤더 추가\n \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n \"Uniai-Native-Domain\": domain,\n \"Uniai-Native-Path\": queryUrl,\n };\n\n // 백엔드 요청 URL 전체\n const nativeUrl = `${domain \|\| \"\"}${queryUrl \|\| \"\"}${getQueryString(urlOptions.searchParams)}`;\n Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n // -------------------------- debug headers 구성; end\n\n // -------------------------- authorization token 구성; start\n\n // 인증 토큰 추가\n // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n const requestHeaders = disabledToken\n ? new Headers(headerOptions)\n : await setTokenRequestHeaders(headerOptions);\n\n if (!disabledLog) {\n nextAPILog(method, routeUrl, url, {\n disabledToken,\n headers: headerOptions,\n headerWithToken: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n });\n }\n\n // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n if (!disabledToken && !requestHeaders) {\n // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n }\n\n // -------------------------- authorization token 구성; end\n\n // -------------------------- fetch options 구성; start\n\n const fetchOptions: API_GetFetchOptionsParams = {\n method,\n headers: requestHeaders,\n };\n\n // body 데이터 구성\n if (method !== \"GET\" && bodyData !== undefined) {\n if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });\n\n const stringifyData = convertObjectToSearchParams(bodyData, {\n method,\n urlOptions,\n }).toString();\n if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });\n\n if (stringifyData) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n Object.assign(fetchOptions, {\n body: [\"string\", \"number\"].includes(typeof bodyData)\n ? String(bodyData)\n : JSON.stringify(bodyData),\n });\n } else {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n }\n }\n\n // -------------------------- fetch options 구성; end\n\n // -------------------------- fetch 실행; start\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, {\n fetchOptions: {\n ...fetchOptions,\n headers: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n },\n });\n return await fetch(url, getFetchOptions(fetchOptions));\n // -------------------------- fetch 실행; end\n}\n\n/\n 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams \| object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n /\nexport async function setDebugResponseHeaders<ResponseData>({\n res,\n domain,\n queryUrl,\n queryString,\n searchParams,\n fullUrl,\n options,\n}: {\n /\n fetch 응답 데이터\n /\n res: ResponseData;\n /\n API 도메인\n * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n /\n domain: string;\n /\n API 엔드포인트 쿼리 path\n /\n queryUrl: string;\n} & Partial<{\n /\n 쿼리스트링\n /\n queryString: string;\n /\n URLSearchParams 객체\n /\n searchParams: URLSearchParams \| object;\n /\n 전체 URL\n /\n fullUrl: string;\n /\n 응답 옵션\n /\n options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n const hasInvalidStatusText =\n typeof options?.statusText === \"string\" &&\n Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n const response = NextResponse.json(\n res,\n hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n );\n\n response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n response.headers.set(\"Uniai-Native-Domain\", domain);\n response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n const url =\n fullUrl \|\|\n `${domain \|\| \"\"}${queryUrl \|\| \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n response.headers.set(\"Uniai-Native-URL\", url);\n\n return response;\n}\n","import type { NextResponse } from \"next/server\";\nimport {\n checkResponsiveDevice,\n checkAppleDevice,\n} from \"@uniai-fe/util-functions\";\n\n/\n 감지된 기기 환경 저장\n */\nexport function setViewportDeviceInfo(\n response: NextResponse,\n userAgent: string,\n): NextResponse {\n const responseUpdate = response;\n\n // 접속 디바이스의 브레이크 포인트 체크\n responseUpdate.headers.set(\n \"X-Responsive-Device\",\n checkResponsiveDevice(userAgent),\n );\n\n // 접속 디바이스의 애플 기기 여부 체크\n responseUpdate.headers.set(\n \"X-Apple-Device\",\n checkAppleDevice(userAgent) ? \"true\" : \"false\",\n );\n\n return responseUpdate;\n}\n"]}

package/dist/index.mjs CHANGED Viewed

@@ -132,7 +132,10 @@ async function authorizedFetch({
   };
   if (method !== "GET" && bodyData !== void 0) {
     if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });
-    const stringifyData = convertObjectToSearchParams(bodyData).toString();
+    const stringifyData = convertObjectToSearchParams(bodyData, {
+      method,
+      urlOptions
+    }).toString();
     if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });
     if (stringifyData) {
       if (!disabledLog)

package/dist/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../api/src/request/module.ts","../src/server/module.ts","../src/runtime-env/module.ts"],"names":["headers","convertObjectToSearchParams"],"mappings":"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","file":"index.mjs","sourcesContent":["import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n API_FetchWithBodyParams,\n API_GetFetchOptionsParams,\n API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/*\n API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n /\nexport const getQueryString = (searchParams?: unknown): string => {\n // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n const serialized = convertObjectToSearchParams(searchParams).toString();\n return serialized ? `?${serialized}` : \"\";\n};\n\n/\n API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query URL\n * @param {unknown[]} messages 로그 메시지\n /\nexport const nextAPILog = (\n method: string,\n routeUrl: string,\n queryUrl?: string,\n ...messages: unknown[]\n) => {\n // 2026-03-19: 배포 환경에서의 모니터링 및 디버깅을 위한 서버 로그 확인을 위해 주석처리함\n // if (process.env.NODE_ENV === \"production\") {\n // return;\n // }\n\n // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n const date = new Date();\n const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n const requestMethod = method.split(\"-\")[0]?.toUpperCase() \|\| \"-\";\n const responseMethod = method.split(\"-\")[1]?.toUpperCase() \|\| requestMethod;\n\n return console.log(\n `\\n`,\n `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n `\\n λ [${requestMethod}] FE route`,\n `\\n ${routeUrl}`,\n ...(queryUrl\n ? [`\\n ═⏵ Ω [${responseMethod}] BE url`, `\\n ${queryUrl}`, `\\n`]\n : []),\n ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n `\\n`,\n );\n};\n\n/\n API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams \| object} [searchParams] 쿼리스트링 원본\n /\nexport const getRouteUrl = (\n routeUrl: string,\n searchParams?: URLSearchParams \| object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/\n API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n /\nexport const generateQueryUrl = ({\n method = \"GET\",\n domain,\n routeUrl,\n queryUrl,\n searchParams,\n log,\n logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n if (!logDisabled) {\n nextAPILog(method, routeUrl, url, {\n ...(log ?? {}),\n ...(searchParams ?? {}),\n });\n }\n\n return url;\n};\n\n/\n API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit \| null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n * method: \"POST\",\n * headers: { \"Content-Type\": \"application/json\" },\n * body: JSON.stringify({ farm_id: 1 }),\n * });\n /\nexport const getFetchOptions = ({\n method,\n headers,\n body,\n}: API_GetFetchOptionsParams): RequestInit => ({\n method,\n // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\n ...(typeof headers === \"undefined\" ? {} : { headers }),\n ...(typeof body === \"undefined\" ? {} : { body }),\n});\n\n/\n API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit \| null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\n /\nexport const fetchWithBody = async <\n BodyDataType = object,\n ResponseType extends object \| Response = Response,\n>({\n domain,\n method,\n routeUrl,\n queryUrl,\n searchParams,\n headers,\n body,\n bodyData,\n isRawResponse,\n alternateResponse,\n debug,\n disabled,\n disabledLog,\n}: API_FetchWithBodyParams<\n BodyDataType,\n ResponseType\n>): Promise<ResponseType> => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n const option = getFetchOptions({ method, headers, body });\n\n if (!body && typeof bodyData !== \"undefined\") {\n // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n const bodyParams = convertObjectToSearchParams(bodyData).toString();\n if (bodyParams === \"\") {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (BODY - DATA)\",\n error: \"데이터가 유효하지 않습니다.\",\n bodyData,\n ...(debug ?? {}),\n });\n return alternateResponse;\n }\n option.body = bodyData as BodyInit;\n }\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"READY\",\n ...option,\n ...(debug ?? {}),\n });\n }\n\n if (disabled) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"FETCH DISABLED\",\n message: \"API 요청제한 활성화됨.\",\n });\n return alternateResponse;\n }\n\n try {\n const responseRaw = await fetch(url, option);\n const responseCode = responseRaw.status;\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n code: responseCode,\n });\n }\n\n if (isRawResponse) {\n return responseRaw as ResponseType;\n }\n return (await responseRaw.json()) as ResponseType;\n } catch (error: unknown) {\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (RESPONSE)\",\n error,\n ...(debug ?? {}),\n });\n }\n return alternateResponse;\n }\n};\n","\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n generateQueryUrl,\n getFetchOptions,\n getQueryString,\n nextAPILog,\n type API_GenerateQueryUrlParams,\n type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/\n 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)\n * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n \n @returns {Promise<HeadersInit \| undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n /\nexport async function setTokenRequestHeaders(\n headerOptions?: HeadersInit,\n disabledLog: boolean = true,\n): Promise<HeadersInit \| undefined> {\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] headerOptions:\",\n Object.fromEntries(new Headers(headerOptions)),\n );\n const nextHeaders = await headers();\n const headerToken = nextHeaders.get(\"Authorization\") \|\| \"\";\n const cookieToken = (await cookies()).get(\"token\")?.value \|\| \"\";\n\n if (!disabledLog)\n console.log(\"[setTokenRequestHeaders] token:\", {\n headers: headerToken,\n cookie: cookieToken,\n });\n // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n const token = headerToken \|\| (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n if (!disabledLog) console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n if (!token) return undefined;\n\n const res = new Headers({\n Authorization: token, // Bearer 포함됨\n ...headerOptions,\n });\n\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] final headers:\",\n Object.fromEntries(res),\n );\n\n return res;\n}\n\n/\n 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)\n * @returns {Promise<Response>} fetch 응답 객체\n /\nexport async function authorizedFetch({\n method = \"GET\",\n disabledToken,\n urlOptions,\n headers,\n bodyData,\n disabledLog,\n}: {\n method?: string;\n disabledToken?: boolean;\n urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n headers?: HeadersInit;\n bodyData?: object;\n disabledLog?: boolean;\n}): Promise<Response> {\n const { domain, routeUrl, queryUrl } = urlOptions;\n\n // 기초 데이터 검증\n if (!domain && !queryUrl) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, \"NO URL\", {\n ...urlOptions,\n });\n\n // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n }\n\n // -------------------------- url 구성; start\n\n // 백엔드 요청 URL\n const url = generateQueryUrl({ ...urlOptions, method });\n if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n // -------------------------- url 구성; end\n\n // -------------------------- debug headers 구성; start\n\n const headerOptions: HeadersInit = {\n // 외부에서 전달된 헤더\n ...headers,\n // 백엔드 디버깅용 헤더 추가\n \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n \"Uniai-Native-Domain\": domain,\n \"Uniai-Native-Path\": queryUrl,\n };\n\n // 백엔드 요청 URL 전체\n const nativeUrl = `${domain \|\| \"\"}${queryUrl \|\| \"\"}${getQueryString(urlOptions.searchParams)}`;\n Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n // -------------------------- debug headers 구성; end\n\n // -------------------------- authorization token 구성; start\n\n // 인증 토큰 추가\n // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n const requestHeaders = disabledToken\n ? new Headers(headerOptions)\n : await setTokenRequestHeaders(headerOptions);\n\n if (!disabledLog) {\n nextAPILog(method, routeUrl, url, {\n disabledToken,\n headers: headerOptions,\n headerWithToken: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n });\n }\n\n // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n if (!disabledToken && !requestHeaders) {\n // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n }\n\n // -------------------------- authorization token 구성; end\n\n // -------------------------- fetch options 구성; start\n\n const fetchOptions: API_GetFetchOptionsParams = {\n method,\n headers: requestHeaders,\n };\n\n // body 데이터 구성\n if (method !== \"GET\" && bodyData !== undefined) {\n if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });\n\n const stringifyData = convertObjectToSearchParams(bodyData).toString();\n if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });\n\n if (stringifyData) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n Object.assign(fetchOptions, {\n body: [\"string\", \"number\"].includes(typeof bodyData)\n ? String(bodyData)\n : JSON.stringify(bodyData),\n });\n } else {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n }\n }\n\n // -------------------------- fetch options 구성; end\n\n // -------------------------- fetch 실행; start\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, {\n fetchOptions: {\n ...fetchOptions,\n headers: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n },\n });\n return await fetch(url, getFetchOptions(fetchOptions));\n // -------------------------- fetch 실행; end\n}\n\n/\n 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams \| object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n /\nexport async function setDebugResponseHeaders<ResponseData>({\n res,\n domain,\n queryUrl,\n queryString,\n searchParams,\n fullUrl,\n options,\n}: {\n /\n fetch 응답 데이터\n /\n res: ResponseData;\n /\n API 도메인\n * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n /\n domain: string;\n /\n API 엔드포인트 쿼리 path\n /\n queryUrl: string;\n} & Partial<{\n /\n 쿼리스트링\n /\n queryString: string;\n /\n URLSearchParams 객체\n /\n searchParams: URLSearchParams \| object;\n /\n 전체 URL\n /\n fullUrl: string;\n /\n 응답 옵션\n /\n options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n const hasInvalidStatusText =\n typeof options?.statusText === \"string\" &&\n Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n const response = NextResponse.json(\n res,\n hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n );\n\n response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n response.headers.set(\"Uniai-Native-Domain\", domain);\n response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n const url =\n fullUrl \|\|\n `${domain \|\| \"\"}${queryUrl \|\| \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n response.headers.set(\"Uniai-Native-URL\", url);\n\n return response;\n}\n","import type { NextResponse } from \"next/server\";\nimport {\n checkResponsiveDevice,\n checkAppleDevice,\n} from \"@uniai-fe/util-functions\";\n\n/\n 감지된 기기 환경 저장\n */\nexport function setViewportDeviceInfo(\n response: NextResponse,\n userAgent: string,\n): NextResponse {\n const responseUpdate = response;\n\n // 접속 디바이스의 브레이크 포인트 체크\n responseUpdate.headers.set(\n \"X-Responsive-Device\",\n checkResponsiveDevice(userAgent),\n );\n\n // 접속 디바이스의 애플 기기 여부 체크\n responseUpdate.headers.set(\n \"X-Apple-Device\",\n checkAppleDevice(userAgent) ? \"true\" : \"false\",\n );\n\n return responseUpdate;\n}\n"]}
1	+ {"version":3,"sources":["../../api/src/request/module.ts","../src/server/module.ts","../src/runtime-env/module.ts"],"names":["headers","convertObjectToSearchParams"],"mappings":"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","file":"index.mjs","sourcesContent":["import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n API_FetchWithBodyParams,\n API_GetFetchOptionsParams,\n API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/*\n API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n /\nexport const getQueryString = (searchParams?: unknown): string => {\n // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n const serialized = convertObjectToSearchParams(searchParams).toString();\n return serialized ? `?${serialized}` : \"\";\n};\n\n/\n API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query URL\n * @param {unknown[]} messages 로그 메시지\n /\nexport const nextAPILog = (\n method: string,\n routeUrl: string,\n queryUrl?: string,\n ...messages: unknown[]\n) => {\n // 2026-03-19: 배포 환경에서의 모니터링 및 디버깅을 위한 서버 로그 확인을 위해 주석처리함\n // if (process.env.NODE_ENV === \"production\") {\n // return;\n // }\n\n // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n const date = new Date();\n const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n const requestMethod = method.split(\"-\")[0]?.toUpperCase() \|\| \"-\";\n const responseMethod = method.split(\"-\")[1]?.toUpperCase() \|\| requestMethod;\n\n return console.log(\n `\\n`,\n `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n `\\n λ [${requestMethod}] FE route`,\n `\\n ${routeUrl}`,\n ...(queryUrl\n ? [`\\n ═⏵ Ω [${responseMethod}] BE url`, `\\n ${queryUrl}`, `\\n`]\n : []),\n ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n `\\n`,\n );\n};\n\n/\n API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams \| object} [searchParams] 쿼리스트링 원본\n /\nexport const getRouteUrl = (\n routeUrl: string,\n searchParams?: URLSearchParams \| object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/\n API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n /\nexport const generateQueryUrl = ({\n method = \"GET\",\n domain,\n routeUrl,\n queryUrl,\n searchParams,\n log,\n logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n if (!logDisabled) {\n nextAPILog(method, routeUrl, url, {\n ...(log ?? {}),\n ...(searchParams ?? {}),\n });\n }\n\n return url;\n};\n\n/\n API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit \| null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n * method: \"POST\",\n * headers: { \"Content-Type\": \"application/json\" },\n * body: JSON.stringify({ farm_id: 1 }),\n * });\n /\nexport const getFetchOptions = ({\n method,\n headers,\n body,\n}: API_GetFetchOptionsParams): RequestInit => ({\n method,\n // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\n ...(typeof headers === \"undefined\" ? {} : { headers }),\n ...(typeof body === \"undefined\" ? {} : { body }),\n});\n\n/\n API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit \| null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\n /\nexport const fetchWithBody = async <\n BodyDataType = object,\n ResponseType extends object \| Response = Response,\n>({\n domain,\n method,\n routeUrl,\n queryUrl,\n searchParams,\n headers,\n body,\n bodyData,\n isRawResponse,\n alternateResponse,\n debug,\n disabled,\n disabledLog,\n}: API_FetchWithBodyParams<\n BodyDataType,\n ResponseType\n>): Promise<ResponseType> => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n const option = getFetchOptions({ method, headers, body });\n\n if (!body && typeof bodyData !== \"undefined\") {\n // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n const bodyParams = convertObjectToSearchParams(bodyData).toString();\n if (bodyParams === \"\") {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (BODY - DATA)\",\n error: \"데이터가 유효하지 않습니다.\",\n bodyData,\n ...(debug ?? {}),\n });\n return alternateResponse;\n }\n option.body = bodyData as BodyInit;\n }\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"READY\",\n ...option,\n ...(debug ?? {}),\n });\n }\n\n if (disabled) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"FETCH DISABLED\",\n message: \"API 요청제한 활성화됨.\",\n });\n return alternateResponse;\n }\n\n try {\n const responseRaw = await fetch(url, option);\n const responseCode = responseRaw.status;\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n code: responseCode,\n });\n }\n\n if (isRawResponse) {\n return responseRaw as ResponseType;\n }\n return (await responseRaw.json()) as ResponseType;\n } catch (error: unknown) {\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (RESPONSE)\",\n error,\n ...(debug ?? {}),\n });\n }\n return alternateResponse;\n }\n};\n","\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n generateQueryUrl,\n getFetchOptions,\n getQueryString,\n nextAPILog,\n type API_GenerateQueryUrlParams,\n type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/\n 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)\n * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n \n @returns {Promise<HeadersInit \| undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n /\nexport async function setTokenRequestHeaders(\n headerOptions?: HeadersInit,\n disabledLog: boolean = true,\n): Promise<HeadersInit \| undefined> {\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] headerOptions:\",\n Object.fromEntries(new Headers(headerOptions)),\n );\n const nextHeaders = await headers();\n const headerToken = nextHeaders.get(\"Authorization\") \|\| \"\";\n const cookieToken = (await cookies()).get(\"token\")?.value \|\| \"\";\n\n if (!disabledLog)\n console.log(\"[setTokenRequestHeaders] token:\", {\n headers: headerToken,\n cookie: cookieToken,\n });\n // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n const token = headerToken \|\| (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n if (!disabledLog) console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n if (!token) return undefined;\n\n const res = new Headers({\n Authorization: token, // Bearer 포함됨\n ...headerOptions,\n });\n\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] final headers:\",\n Object.fromEntries(res),\n );\n\n return res;\n}\n\n/\n 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)\n * @returns {Promise<Response>} fetch 응답 객체\n /\nexport async function authorizedFetch({\n method = \"GET\",\n disabledToken,\n urlOptions,\n headers,\n bodyData,\n disabledLog,\n}: {\n method?: string;\n disabledToken?: boolean;\n urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n headers?: HeadersInit;\n bodyData?: object;\n disabledLog?: boolean;\n}): Promise<Response> {\n const { domain, routeUrl, queryUrl } = urlOptions;\n\n // 기초 데이터 검증\n if (!domain && !queryUrl) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, \"NO URL\", {\n ...urlOptions,\n });\n\n // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n }\n\n // -------------------------- url 구성; start\n\n // 백엔드 요청 URL\n const url = generateQueryUrl({ ...urlOptions, method });\n if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n // -------------------------- url 구성; end\n\n // -------------------------- debug headers 구성; start\n\n const headerOptions: HeadersInit = {\n // 외부에서 전달된 헤더\n ...headers,\n // 백엔드 디버깅용 헤더 추가\n \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n \"Uniai-Native-Domain\": domain,\n \"Uniai-Native-Path\": queryUrl,\n };\n\n // 백엔드 요청 URL 전체\n const nativeUrl = `${domain \|\| \"\"}${queryUrl \|\| \"\"}${getQueryString(urlOptions.searchParams)}`;\n Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n // -------------------------- debug headers 구성; end\n\n // -------------------------- authorization token 구성; start\n\n // 인증 토큰 추가\n // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n const requestHeaders = disabledToken\n ? new Headers(headerOptions)\n : await setTokenRequestHeaders(headerOptions);\n\n if (!disabledLog) {\n nextAPILog(method, routeUrl, url, {\n disabledToken,\n headers: headerOptions,\n headerWithToken: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n });\n }\n\n // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n if (!disabledToken && !requestHeaders) {\n // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n }\n\n // -------------------------- authorization token 구성; end\n\n // -------------------------- fetch options 구성; start\n\n const fetchOptions: API_GetFetchOptionsParams = {\n method,\n headers: requestHeaders,\n };\n\n // body 데이터 구성\n if (method !== \"GET\" && bodyData !== undefined) {\n if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });\n\n const stringifyData = convertObjectToSearchParams(bodyData, {\n method,\n urlOptions,\n }).toString();\n if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });\n\n if (stringifyData) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n Object.assign(fetchOptions, {\n body: [\"string\", \"number\"].includes(typeof bodyData)\n ? String(bodyData)\n : JSON.stringify(bodyData),\n });\n } else {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n }\n }\n\n // -------------------------- fetch options 구성; end\n\n // -------------------------- fetch 실행; start\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, {\n fetchOptions: {\n ...fetchOptions,\n headers: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n },\n });\n return await fetch(url, getFetchOptions(fetchOptions));\n // -------------------------- fetch 실행; end\n}\n\n/\n 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams \| object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n /\nexport async function setDebugResponseHeaders<ResponseData>({\n res,\n domain,\n queryUrl,\n queryString,\n searchParams,\n fullUrl,\n options,\n}: {\n /\n fetch 응답 데이터\n /\n res: ResponseData;\n /\n API 도메인\n * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n /\n domain: string;\n /\n API 엔드포인트 쿼리 path\n /\n queryUrl: string;\n} & Partial<{\n /\n 쿼리스트링\n /\n queryString: string;\n /\n URLSearchParams 객체\n /\n searchParams: URLSearchParams \| object;\n /\n 전체 URL\n /\n fullUrl: string;\n /\n 응답 옵션\n /\n options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n const hasInvalidStatusText =\n typeof options?.statusText === \"string\" &&\n Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n const response = NextResponse.json(\n res,\n hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n );\n\n response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n response.headers.set(\"Uniai-Native-Domain\", domain);\n response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n const url =\n fullUrl \|\|\n `${domain \|\| \"\"}${queryUrl \|\| \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n response.headers.set(\"Uniai-Native-URL\", url);\n\n return response;\n}\n","import type { NextResponse } from \"next/server\";\nimport {\n checkResponsiveDevice,\n checkAppleDevice,\n} from \"@uniai-fe/util-functions\";\n\n/\n 감지된 기기 환경 저장\n */\nexport function setViewportDeviceInfo(\n response: NextResponse,\n userAgent: string,\n): NextResponse {\n const responseUpdate = response;\n\n // 접속 디바이스의 브레이크 포인트 체크\n responseUpdate.headers.set(\n \"X-Responsive-Device\",\n checkResponsiveDevice(userAgent),\n );\n\n // 접속 디바이스의 애플 기기 여부 체크\n responseUpdate.headers.set(\n \"X-Apple-Device\",\n checkAppleDevice(userAgent) ? \"true\" : \"false\",\n );\n\n return responseUpdate;\n}\n"]}

package/dist/server/index.cjs CHANGED Viewed

@@ -164,7 +164,10 @@ async function authorizedFetch({
   };
   if (method !== "GET" && bodyData !== void 0) {
     if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });
-    const stringifyData = (0, import_util_functions2.convertObjectToSearchParams)(bodyData).toString();
+    const stringifyData = (0, import_util_functions2.convertObjectToSearchParams)(bodyData, {
+      method,
+      urlOptions
+    }).toString();
     if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });
     if (stringifyData) {
       if (!disabledLog)

package/dist/server/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/server/index.ts","../../src/server/module.ts","../../../api/src/response/module.ts","../../../api/src/request/module.ts"],"sourcesContent":["export * from \"./module\";\n","\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n generateQueryUrl,\n getFetchOptions,\n getQueryString,\n nextAPILog,\n type API_GenerateQueryUrlParams,\n type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/*\n 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)\n * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n \n @returns {Promise<HeadersInit \| undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n /\nexport async function setTokenRequestHeaders(\n headerOptions?: HeadersInit,\n disabledLog: boolean = true,\n): Promise<HeadersInit \| undefined> {\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] headerOptions:\",\n Object.fromEntries(new Headers(headerOptions)),\n );\n const nextHeaders = await headers();\n const headerToken = nextHeaders.get(\"Authorization\") \|\| \"\";\n const cookieToken = (await cookies()).get(\"token\")?.value \|\| \"\";\n\n if (!disabledLog)\n console.log(\"[setTokenRequestHeaders] token:\", {\n headers: headerToken,\n cookie: cookieToken,\n });\n // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n const token = headerToken \|\| (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n if (!disabledLog) console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n if (!token) return undefined;\n\n const res = new Headers({\n Authorization: token, // Bearer 포함됨\n ...headerOptions,\n });\n\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] final headers:\",\n Object.fromEntries(res),\n );\n\n return res;\n}\n\n/\n 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)\n * @returns {Promise<Response>} fetch 응답 객체\n /\nexport async function authorizedFetch({\n method = \"GET\",\n disabledToken,\n urlOptions,\n headers,\n bodyData,\n disabledLog,\n}: {\n method?: string;\n disabledToken?: boolean;\n urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n headers?: HeadersInit;\n bodyData?: object;\n disabledLog?: boolean;\n}): Promise<Response> {\n const { domain, routeUrl, queryUrl } = urlOptions;\n\n // 기초 데이터 검증\n if (!domain && !queryUrl) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, \"NO URL\", {\n ...urlOptions,\n });\n\n // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n }\n\n // -------------------------- url 구성; start\n\n // 백엔드 요청 URL\n const url = generateQueryUrl({ ...urlOptions, method });\n if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n // -------------------------- url 구성; end\n\n // -------------------------- debug headers 구성; start\n\n const headerOptions: HeadersInit = {\n // 외부에서 전달된 헤더\n ...headers,\n // 백엔드 디버깅용 헤더 추가\n \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n \"Uniai-Native-Domain\": domain,\n \"Uniai-Native-Path\": queryUrl,\n };\n\n // 백엔드 요청 URL 전체\n const nativeUrl = `${domain \|\| \"\"}${queryUrl \|\| \"\"}${getQueryString(urlOptions.searchParams)}`;\n Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n // -------------------------- debug headers 구성; end\n\n // -------------------------- authorization token 구성; start\n\n // 인증 토큰 추가\n // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n const requestHeaders = disabledToken\n ? new Headers(headerOptions)\n : await setTokenRequestHeaders(headerOptions);\n\n if (!disabledLog) {\n nextAPILog(method, routeUrl, url, {\n disabledToken,\n headers: headerOptions,\n headerWithToken: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n });\n }\n\n // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n if (!disabledToken && !requestHeaders) {\n // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n }\n\n // -------------------------- authorization token 구성; end\n\n // -------------------------- fetch options 구성; start\n\n const fetchOptions: API_GetFetchOptionsParams = {\n method,\n headers: requestHeaders,\n };\n\n // body 데이터 구성\n if (method !== \"GET\" && bodyData !== undefined) {\n if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });\n\n const stringifyData = convertObjectToSearchParams(bodyData).toString();\n if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });\n\n if (stringifyData) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n Object.assign(fetchOptions, {\n body: [\"string\", \"number\"].includes(typeof bodyData)\n ? String(bodyData)\n : JSON.stringify(bodyData),\n });\n } else {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n }\n }\n\n // -------------------------- fetch options 구성; end\n\n // -------------------------- fetch 실행; start\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, {\n fetchOptions: {\n ...fetchOptions,\n headers: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n },\n });\n return await fetch(url, getFetchOptions(fetchOptions));\n // -------------------------- fetch 실행; end\n}\n\n/\n 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams \| object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n /\nexport async function setDebugResponseHeaders<ResponseData>({\n res,\n domain,\n queryUrl,\n queryString,\n searchParams,\n fullUrl,\n options,\n}: {\n /\n fetch 응답 데이터\n /\n res: ResponseData;\n /\n API 도메인\n * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n /\n domain: string;\n /\n API 엔드포인트 쿼리 path\n /\n queryUrl: string;\n} & Partial<{\n /\n 쿼리스트링\n /\n queryString: string;\n /\n URLSearchParams 객체\n /\n searchParams: URLSearchParams \| object;\n /\n 전체 URL\n /\n fullUrl: string;\n /\n 응답 옵션\n /\n options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n const hasInvalidStatusText =\n typeof options?.statusText === \"string\" &&\n Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n const response = NextResponse.json(\n res,\n hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n );\n\n response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n response.headers.set(\"Uniai-Native-Domain\", domain);\n response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n const url =\n fullUrl \|\|\n `${domain \|\| \"\"}${queryUrl \|\| \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n response.headers.set(\"Uniai-Native-URL\", url);\n\n return response;\n}\n","import type { API_Res_Base } from \"./types\";\n\nexport const setAlternateResponse = <ResponseDataType>(\n errorMessage: string,\n data: ResponseDataType,\n): API_Res_Base<ResponseDataType> => ({\n status: \"fail\",\n errors: [\n { field_name: \"\", message: errorMessage \|\| \"데이터 조회에 실패했습니다.\" },\n ],\n data,\n});\n","import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n API_FetchWithBodyParams,\n API_GetFetchOptionsParams,\n API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/\n API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n /\nexport const getQueryString = (searchParams?: unknown): string => {\n // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n const serialized = convertObjectToSearchParams(searchParams).toString();\n return serialized ? `?${serialized}` : \"\";\n};\n\n/\n API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query URL\n * @param {unknown[]} messages 로그 메시지\n /\nexport const nextAPILog = (\n method: string,\n routeUrl: string,\n queryUrl?: string,\n ...messages: unknown[]\n) => {\n // 2026-03-19: 배포 환경에서의 모니터링 및 디버깅을 위한 서버 로그 확인을 위해 주석처리함\n // if (process.env.NODE_ENV === \"production\") {\n // return;\n // }\n\n // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n const date = new Date();\n const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n const requestMethod = method.split(\"-\")[0]?.toUpperCase() \|\| \"-\";\n const responseMethod = method.split(\"-\")[1]?.toUpperCase() \|\| requestMethod;\n\n return console.log(\n `\\n`,\n `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n `\\n λ [${requestMethod}] FE route`,\n `\\n ${routeUrl}`,\n ...(queryUrl\n ? [`\\n ═⏵ Ω [${responseMethod}] BE url`, `\\n ${queryUrl}`, `\\n`]\n : []),\n ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n `\\n`,\n );\n};\n\n/\n API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams \| object} [searchParams] 쿼리스트링 원본\n /\nexport const getRouteUrl = (\n routeUrl: string,\n searchParams?: URLSearchParams \| object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/\n API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n /\nexport const generateQueryUrl = ({\n method = \"GET\",\n domain,\n routeUrl,\n queryUrl,\n searchParams,\n log,\n logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n if (!logDisabled) {\n nextAPILog(method, routeUrl, url, {\n ...(log ?? {}),\n ...(searchParams ?? {}),\n });\n }\n\n return url;\n};\n\n/\n API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit \| null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n * method: \"POST\",\n * headers: { \"Content-Type\": \"application/json\" },\n * body: JSON.stringify({ farm_id: 1 }),\n * });\n /\nexport const getFetchOptions = ({\n method,\n headers,\n body,\n}: API_GetFetchOptionsParams): RequestInit => ({\n method,\n // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\n ...(typeof headers === \"undefined\" ? {} : { headers }),\n ...(typeof body === \"undefined\" ? {} : { body }),\n});\n\n/\n API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit \| null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\n */\nexport const fetchWithBody = async <\n BodyDataType = object,\n ResponseType extends object \| Response = Response,\n>({\n domain,\n method,\n routeUrl,\n queryUrl,\n searchParams,\n headers,\n body,\n bodyData,\n isRawResponse,\n alternateResponse,\n debug,\n disabled,\n disabledLog,\n}: API_FetchWithBodyParams<\n BodyDataType,\n ResponseType\n>): Promise<ResponseType> => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n const option = getFetchOptions({ method, headers, body });\n\n if (!body && typeof bodyData !== \"undefined\") {\n // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n const bodyParams = convertObjectToSearchParams(bodyData).toString();\n if (bodyParams === \"\") {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (BODY - DATA)\",\n error: \"데이터가 유효하지 않습니다.\",\n bodyData,\n ...(debug ?? {}),\n });\n return alternateResponse;\n }\n option.body = bodyData as BodyInit;\n }\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"READY\",\n ...option,\n ...(debug ?? {}),\n });\n }\n\n if (disabled) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"FETCH DISABLED\",\n message: \"API 요청제한 활성화됨.\",\n });\n return alternateResponse;\n }\n\n try {\n const responseRaw = await fetch(url, option);\n const responseCode = responseRaw.status;\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n code: responseCode,\n });\n }\n\n if (isRawResponse) {\n return responseRaw as ResponseType;\n }\n return (await responseRaw.json()) as ResponseType;\n } catch (error: unknown) {\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (RESPONSE)\",\n error,\n ...(debug ?? {}),\n });\n }\n return alternateResponse;\n }\n};\n"],"mappings":"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","names":["headers","import_util_functions","headers"]}
1	+ {"version":3,"sources":["../../src/server/index.ts","../../src/server/module.ts","../../../api/src/response/module.ts","../../../api/src/request/module.ts"],"sourcesContent":["export * from \"./module\";\n","\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n generateQueryUrl,\n getFetchOptions,\n getQueryString,\n nextAPILog,\n type API_GenerateQueryUrlParams,\n type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/*\n 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)\n * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n \n @returns {Promise<HeadersInit \| undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n /\nexport async function setTokenRequestHeaders(\n headerOptions?: HeadersInit,\n disabledLog: boolean = true,\n): Promise<HeadersInit \| undefined> {\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] headerOptions:\",\n Object.fromEntries(new Headers(headerOptions)),\n );\n const nextHeaders = await headers();\n const headerToken = nextHeaders.get(\"Authorization\") \|\| \"\";\n const cookieToken = (await cookies()).get(\"token\")?.value \|\| \"\";\n\n if (!disabledLog)\n console.log(\"[setTokenRequestHeaders] token:\", {\n headers: headerToken,\n cookie: cookieToken,\n });\n // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n const token = headerToken \|\| (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n if (!disabledLog) console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n if (!token) return undefined;\n\n const res = new Headers({\n Authorization: token, // Bearer 포함됨\n ...headerOptions,\n });\n\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] final headers:\",\n Object.fromEntries(res),\n );\n\n return res;\n}\n\n/\n 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)\n * @returns {Promise<Response>} fetch 응답 객체\n /\nexport async function authorizedFetch({\n method = \"GET\",\n disabledToken,\n urlOptions,\n headers,\n bodyData,\n disabledLog,\n}: {\n method?: string;\n disabledToken?: boolean;\n urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n headers?: HeadersInit;\n bodyData?: object;\n disabledLog?: boolean;\n}): Promise<Response> {\n const { domain, routeUrl, queryUrl } = urlOptions;\n\n // 기초 데이터 검증\n if (!domain && !queryUrl) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, \"NO URL\", {\n ...urlOptions,\n });\n\n // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n }\n\n // -------------------------- url 구성; start\n\n // 백엔드 요청 URL\n const url = generateQueryUrl({ ...urlOptions, method });\n if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n // -------------------------- url 구성; end\n\n // -------------------------- debug headers 구성; start\n\n const headerOptions: HeadersInit = {\n // 외부에서 전달된 헤더\n ...headers,\n // 백엔드 디버깅용 헤더 추가\n \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n \"Uniai-Native-Domain\": domain,\n \"Uniai-Native-Path\": queryUrl,\n };\n\n // 백엔드 요청 URL 전체\n const nativeUrl = `${domain \|\| \"\"}${queryUrl \|\| \"\"}${getQueryString(urlOptions.searchParams)}`;\n Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n // -------------------------- debug headers 구성; end\n\n // -------------------------- authorization token 구성; start\n\n // 인증 토큰 추가\n // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n const requestHeaders = disabledToken\n ? new Headers(headerOptions)\n : await setTokenRequestHeaders(headerOptions);\n\n if (!disabledLog) {\n nextAPILog(method, routeUrl, url, {\n disabledToken,\n headers: headerOptions,\n headerWithToken: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n });\n }\n\n // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n if (!disabledToken && !requestHeaders) {\n // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n }\n\n // -------------------------- authorization token 구성; end\n\n // -------------------------- fetch options 구성; start\n\n const fetchOptions: API_GetFetchOptionsParams = {\n method,\n headers: requestHeaders,\n };\n\n // body 데이터 구성\n if (method !== \"GET\" && bodyData !== undefined) {\n if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });\n\n const stringifyData = convertObjectToSearchParams(bodyData, {\n method,\n urlOptions,\n }).toString();\n if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });\n\n if (stringifyData) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n Object.assign(fetchOptions, {\n body: [\"string\", \"number\"].includes(typeof bodyData)\n ? String(bodyData)\n : JSON.stringify(bodyData),\n });\n } else {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n }\n }\n\n // -------------------------- fetch options 구성; end\n\n // -------------------------- fetch 실행; start\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, {\n fetchOptions: {\n ...fetchOptions,\n headers: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n },\n });\n return await fetch(url, getFetchOptions(fetchOptions));\n // -------------------------- fetch 실행; end\n}\n\n/\n 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams \| object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n /\nexport async function setDebugResponseHeaders<ResponseData>({\n res,\n domain,\n queryUrl,\n queryString,\n searchParams,\n fullUrl,\n options,\n}: {\n /\n fetch 응답 데이터\n /\n res: ResponseData;\n /\n API 도메인\n * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n /\n domain: string;\n /\n API 엔드포인트 쿼리 path\n /\n queryUrl: string;\n} & Partial<{\n /\n 쿼리스트링\n /\n queryString: string;\n /\n URLSearchParams 객체\n /\n searchParams: URLSearchParams \| object;\n /\n 전체 URL\n /\n fullUrl: string;\n /\n 응답 옵션\n /\n options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n const hasInvalidStatusText =\n typeof options?.statusText === \"string\" &&\n Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n const response = NextResponse.json(\n res,\n hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n );\n\n response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n response.headers.set(\"Uniai-Native-Domain\", domain);\n response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n const url =\n fullUrl \|\|\n `${domain \|\| \"\"}${queryUrl \|\| \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n response.headers.set(\"Uniai-Native-URL\", url);\n\n return response;\n}\n","import type { API_Res_Base } from \"./types\";\n\nexport const setAlternateResponse = <ResponseDataType>(\n errorMessage: string,\n data: ResponseDataType,\n): API_Res_Base<ResponseDataType> => ({\n status: \"fail\",\n errors: [\n { field_name: \"\", message: errorMessage \|\| \"데이터 조회에 실패했습니다.\" },\n ],\n data,\n});\n","import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n API_FetchWithBodyParams,\n API_GetFetchOptionsParams,\n API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/\n API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n /\nexport const getQueryString = (searchParams?: unknown): string => {\n // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n const serialized = convertObjectToSearchParams(searchParams).toString();\n return serialized ? `?${serialized}` : \"\";\n};\n\n/\n API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query URL\n * @param {unknown[]} messages 로그 메시지\n /\nexport const nextAPILog = (\n method: string,\n routeUrl: string,\n queryUrl?: string,\n ...messages: unknown[]\n) => {\n // 2026-03-19: 배포 환경에서의 모니터링 및 디버깅을 위한 서버 로그 확인을 위해 주석처리함\n // if (process.env.NODE_ENV === \"production\") {\n // return;\n // }\n\n // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n const date = new Date();\n const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n const requestMethod = method.split(\"-\")[0]?.toUpperCase() \|\| \"-\";\n const responseMethod = method.split(\"-\")[1]?.toUpperCase() \|\| requestMethod;\n\n return console.log(\n `\\n`,\n `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n `\\n λ [${requestMethod}] FE route`,\n `\\n ${routeUrl}`,\n ...(queryUrl\n ? [`\\n ═⏵ Ω [${responseMethod}] BE url`, `\\n ${queryUrl}`, `\\n`]\n : []),\n ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n `\\n`,\n );\n};\n\n/\n API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams \| object} [searchParams] 쿼리스트링 원본\n /\nexport const getRouteUrl = (\n routeUrl: string,\n searchParams?: URLSearchParams \| object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/\n API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n /\nexport const generateQueryUrl = ({\n method = \"GET\",\n domain,\n routeUrl,\n queryUrl,\n searchParams,\n log,\n logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n if (!logDisabled) {\n nextAPILog(method, routeUrl, url, {\n ...(log ?? {}),\n ...(searchParams ?? {}),\n });\n }\n\n return url;\n};\n\n/\n API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit \| null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n * method: \"POST\",\n * headers: { \"Content-Type\": \"application/json\" },\n * body: JSON.stringify({ farm_id: 1 }),\n * });\n /\nexport const getFetchOptions = ({\n method,\n headers,\n body,\n}: API_GetFetchOptionsParams): RequestInit => ({\n method,\n // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\n ...(typeof headers === \"undefined\" ? {} : { headers }),\n ...(typeof body === \"undefined\" ? {} : { body }),\n});\n\n/\n API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit \| null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\n */\nexport const fetchWithBody = async <\n BodyDataType = object,\n ResponseType extends object \| Response = Response,\n>({\n domain,\n method,\n routeUrl,\n queryUrl,\n searchParams,\n headers,\n body,\n bodyData,\n isRawResponse,\n alternateResponse,\n debug,\n disabled,\n disabledLog,\n}: API_FetchWithBodyParams<\n BodyDataType,\n ResponseType\n>): Promise<ResponseType> => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n const option = getFetchOptions({ method, headers, body });\n\n if (!body && typeof bodyData !== \"undefined\") {\n // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n const bodyParams = convertObjectToSearchParams(bodyData).toString();\n if (bodyParams === \"\") {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (BODY - DATA)\",\n error: \"데이터가 유효하지 않습니다.\",\n bodyData,\n ...(debug ?? {}),\n });\n return alternateResponse;\n }\n option.body = bodyData as BodyInit;\n }\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"READY\",\n ...option,\n ...(debug ?? {}),\n });\n }\n\n if (disabled) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"FETCH DISABLED\",\n message: \"API 요청제한 활성화됨.\",\n });\n return alternateResponse;\n }\n\n try {\n const responseRaw = await fetch(url, option);\n const responseCode = responseRaw.status;\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n code: responseCode,\n });\n }\n\n if (isRawResponse) {\n return responseRaw as ResponseType;\n }\n return (await responseRaw.json()) as ResponseType;\n } catch (error: unknown) {\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (RESPONSE)\",\n error,\n ...(debug ?? {}),\n });\n }\n return alternateResponse;\n }\n};\n"],"mappings":"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","names":["headers","import_util_functions","headers"]}

package/dist/server/index.mjs CHANGED Viewed

@@ -136,7 +136,10 @@ async function authorizedFetch({
   };
   if (method !== "GET" && bodyData !== void 0) {
     if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });
-    const stringifyData = convertObjectToSearchParams2(bodyData).toString();
+    const stringifyData = convertObjectToSearchParams2(bodyData, {
+      method,
+      urlOptions
+    }).toString();
     if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });
     if (stringifyData) {
       if (!disabledLog)

package/dist/server/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/server/module.ts","../../../api/src/response/module.ts","../../../api/src/request/module.ts"],"sourcesContent":["\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n generateQueryUrl,\n getFetchOptions,\n getQueryString,\n nextAPILog,\n type API_GenerateQueryUrlParams,\n type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/*\n 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)\n * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n \n @returns {Promise<HeadersInit \| undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n /\nexport async function setTokenRequestHeaders(\n headerOptions?: HeadersInit,\n disabledLog: boolean = true,\n): Promise<HeadersInit \| undefined> {\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] headerOptions:\",\n Object.fromEntries(new Headers(headerOptions)),\n );\n const nextHeaders = await headers();\n const headerToken = nextHeaders.get(\"Authorization\") \|\| \"\";\n const cookieToken = (await cookies()).get(\"token\")?.value \|\| \"\";\n\n if (!disabledLog)\n console.log(\"[setTokenRequestHeaders] token:\", {\n headers: headerToken,\n cookie: cookieToken,\n });\n // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n const token = headerToken \|\| (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n if (!disabledLog) console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n if (!token) return undefined;\n\n const res = new Headers({\n Authorization: token, // Bearer 포함됨\n ...headerOptions,\n });\n\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] final headers:\",\n Object.fromEntries(res),\n );\n\n return res;\n}\n\n/\n 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)\n * @returns {Promise<Response>} fetch 응답 객체\n /\nexport async function authorizedFetch({\n method = \"GET\",\n disabledToken,\n urlOptions,\n headers,\n bodyData,\n disabledLog,\n}: {\n method?: string;\n disabledToken?: boolean;\n urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n headers?: HeadersInit;\n bodyData?: object;\n disabledLog?: boolean;\n}): Promise<Response> {\n const { domain, routeUrl, queryUrl } = urlOptions;\n\n // 기초 데이터 검증\n if (!domain && !queryUrl) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, \"NO URL\", {\n ...urlOptions,\n });\n\n // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n }\n\n // -------------------------- url 구성; start\n\n // 백엔드 요청 URL\n const url = generateQueryUrl({ ...urlOptions, method });\n if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n // -------------------------- url 구성; end\n\n // -------------------------- debug headers 구성; start\n\n const headerOptions: HeadersInit = {\n // 외부에서 전달된 헤더\n ...headers,\n // 백엔드 디버깅용 헤더 추가\n \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n \"Uniai-Native-Domain\": domain,\n \"Uniai-Native-Path\": queryUrl,\n };\n\n // 백엔드 요청 URL 전체\n const nativeUrl = `${domain \|\| \"\"}${queryUrl \|\| \"\"}${getQueryString(urlOptions.searchParams)}`;\n Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n // -------------------------- debug headers 구성; end\n\n // -------------------------- authorization token 구성; start\n\n // 인증 토큰 추가\n // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n const requestHeaders = disabledToken\n ? new Headers(headerOptions)\n : await setTokenRequestHeaders(headerOptions);\n\n if (!disabledLog) {\n nextAPILog(method, routeUrl, url, {\n disabledToken,\n headers: headerOptions,\n headerWithToken: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n });\n }\n\n // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n if (!disabledToken && !requestHeaders) {\n // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n }\n\n // -------------------------- authorization token 구성; end\n\n // -------------------------- fetch options 구성; start\n\n const fetchOptions: API_GetFetchOptionsParams = {\n method,\n headers: requestHeaders,\n };\n\n // body 데이터 구성\n if (method !== \"GET\" && bodyData !== undefined) {\n if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });\n\n const stringifyData = convertObjectToSearchParams(bodyData).toString();\n if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });\n\n if (stringifyData) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n Object.assign(fetchOptions, {\n body: [\"string\", \"number\"].includes(typeof bodyData)\n ? String(bodyData)\n : JSON.stringify(bodyData),\n });\n } else {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n }\n }\n\n // -------------------------- fetch options 구성; end\n\n // -------------------------- fetch 실행; start\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, {\n fetchOptions: {\n ...fetchOptions,\n headers: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n },\n });\n return await fetch(url, getFetchOptions(fetchOptions));\n // -------------------------- fetch 실행; end\n}\n\n/\n 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams \| object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n /\nexport async function setDebugResponseHeaders<ResponseData>({\n res,\n domain,\n queryUrl,\n queryString,\n searchParams,\n fullUrl,\n options,\n}: {\n /\n fetch 응답 데이터\n /\n res: ResponseData;\n /\n API 도메인\n * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n /\n domain: string;\n /\n API 엔드포인트 쿼리 path\n /\n queryUrl: string;\n} & Partial<{\n /\n 쿼리스트링\n /\n queryString: string;\n /\n URLSearchParams 객체\n /\n searchParams: URLSearchParams \| object;\n /\n 전체 URL\n /\n fullUrl: string;\n /\n 응답 옵션\n /\n options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n const hasInvalidStatusText =\n typeof options?.statusText === \"string\" &&\n Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n const response = NextResponse.json(\n res,\n hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n );\n\n response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n response.headers.set(\"Uniai-Native-Domain\", domain);\n response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n const url =\n fullUrl \|\|\n `${domain \|\| \"\"}${queryUrl \|\| \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n response.headers.set(\"Uniai-Native-URL\", url);\n\n return response;\n}\n","import type { API_Res_Base } from \"./types\";\n\nexport const setAlternateResponse = <ResponseDataType>(\n errorMessage: string,\n data: ResponseDataType,\n): API_Res_Base<ResponseDataType> => ({\n status: \"fail\",\n errors: [\n { field_name: \"\", message: errorMessage \|\| \"데이터 조회에 실패했습니다.\" },\n ],\n data,\n});\n","import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n API_FetchWithBodyParams,\n API_GetFetchOptionsParams,\n API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/\n API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n /\nexport const getQueryString = (searchParams?: unknown): string => {\n // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n const serialized = convertObjectToSearchParams(searchParams).toString();\n return serialized ? `?${serialized}` : \"\";\n};\n\n/\n API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query URL\n * @param {unknown[]} messages 로그 메시지\n /\nexport const nextAPILog = (\n method: string,\n routeUrl: string,\n queryUrl?: string,\n ...messages: unknown[]\n) => {\n // 2026-03-19: 배포 환경에서의 모니터링 및 디버깅을 위한 서버 로그 확인을 위해 주석처리함\n // if (process.env.NODE_ENV === \"production\") {\n // return;\n // }\n\n // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n const date = new Date();\n const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n const requestMethod = method.split(\"-\")[0]?.toUpperCase() \|\| \"-\";\n const responseMethod = method.split(\"-\")[1]?.toUpperCase() \|\| requestMethod;\n\n return console.log(\n `\\n`,\n `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n `\\n λ [${requestMethod}] FE route`,\n `\\n ${routeUrl}`,\n ...(queryUrl\n ? [`\\n ═⏵ Ω [${responseMethod}] BE url`, `\\n ${queryUrl}`, `\\n`]\n : []),\n ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n `\\n`,\n );\n};\n\n/\n API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams \| object} [searchParams] 쿼리스트링 원본\n /\nexport const getRouteUrl = (\n routeUrl: string,\n searchParams?: URLSearchParams \| object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/\n API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n /\nexport const generateQueryUrl = ({\n method = \"GET\",\n domain,\n routeUrl,\n queryUrl,\n searchParams,\n log,\n logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n if (!logDisabled) {\n nextAPILog(method, routeUrl, url, {\n ...(log ?? {}),\n ...(searchParams ?? {}),\n });\n }\n\n return url;\n};\n\n/\n API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit \| null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n * method: \"POST\",\n * headers: { \"Content-Type\": \"application/json\" },\n * body: JSON.stringify({ farm_id: 1 }),\n * });\n /\nexport const getFetchOptions = ({\n method,\n headers,\n body,\n}: API_GetFetchOptionsParams): RequestInit => ({\n method,\n // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\n ...(typeof headers === \"undefined\" ? {} : { headers }),\n ...(typeof body === \"undefined\" ? {} : { body }),\n});\n\n/\n API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit \| null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\n */\nexport const fetchWithBody = async <\n BodyDataType = object,\n ResponseType extends object \| Response = Response,\n>({\n domain,\n method,\n routeUrl,\n queryUrl,\n searchParams,\n headers,\n body,\n bodyData,\n isRawResponse,\n alternateResponse,\n debug,\n disabled,\n disabledLog,\n}: API_FetchWithBodyParams<\n BodyDataType,\n ResponseType\n>): Promise<ResponseType> => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n const option = getFetchOptions({ method, headers, body });\n\n if (!body && typeof bodyData !== \"undefined\") {\n // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n const bodyParams = convertObjectToSearchParams(bodyData).toString();\n if (bodyParams === \"\") {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (BODY - DATA)\",\n error: \"데이터가 유효하지 않습니다.\",\n bodyData,\n ...(debug ?? {}),\n });\n return alternateResponse;\n }\n option.body = bodyData as BodyInit;\n }\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"READY\",\n ...option,\n ...(debug ?? {}),\n });\n }\n\n if (disabled) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"FETCH DISABLED\",\n message: \"API 요청제한 활성화됨.\",\n });\n return alternateResponse;\n }\n\n try {\n const responseRaw = await fetch(url, option);\n const responseCode = responseRaw.status;\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n code: responseCode,\n });\n }\n\n if (isRawResponse) {\n return responseRaw as ResponseType;\n }\n return (await responseRaw.json()) as ResponseType;\n } catch (error: unknown) {\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (RESPONSE)\",\n error,\n ...(debug ?? {}),\n });\n }\n return alternateResponse;\n }\n};\n"],"mappings":"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","names":["headers","convertObjectToSearchParams","headers"]}
1	+ {"version":3,"sources":["../../src/server/module.ts","../../../api/src/response/module.ts","../../../api/src/request/module.ts"],"sourcesContent":["\"use server\";\n\nimport { cookies, headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport {\n generateQueryUrl,\n getFetchOptions,\n getQueryString,\n nextAPILog,\n type API_GenerateQueryUrlParams,\n type API_GetFetchOptionsParams,\n} from \"@uniai-fe/util-api\";\nimport { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\n\n/*\n 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n * @see middleware.ts\n * @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)\n * @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n \n @returns {Promise<HeadersInit \| undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n /\nexport async function setTokenRequestHeaders(\n headerOptions?: HeadersInit,\n disabledLog: boolean = true,\n): Promise<HeadersInit \| undefined> {\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] headerOptions:\",\n Object.fromEntries(new Headers(headerOptions)),\n );\n const nextHeaders = await headers();\n const headerToken = nextHeaders.get(\"Authorization\") \|\| \"\";\n const cookieToken = (await cookies()).get(\"token\")?.value \|\| \"\";\n\n if (!disabledLog)\n console.log(\"[setTokenRequestHeaders] token:\", {\n headers: headerToken,\n cookie: cookieToken,\n });\n // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n const token = headerToken \|\| (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n if (!disabledLog) console.log(\"[setTokenRequestHeaders] final token:\", token);\n\n if (!token) return undefined;\n\n const res = new Headers({\n Authorization: token, // Bearer 포함됨\n ...headerOptions,\n });\n\n if (!disabledLog)\n console.log(\n \"[setTokenRequestHeaders] final headers:\",\n Object.fromEntries(res),\n );\n\n return res;\n}\n\n/\n 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)\n * @returns {Promise<Response>} fetch 응답 객체\n /\nexport async function authorizedFetch({\n method = \"GET\",\n disabledToken,\n urlOptions,\n headers,\n bodyData,\n disabledLog,\n}: {\n method?: string;\n disabledToken?: boolean;\n urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n headers?: HeadersInit;\n bodyData?: object;\n disabledLog?: boolean;\n}): Promise<Response> {\n const { domain, routeUrl, queryUrl } = urlOptions;\n\n // 기초 데이터 검증\n if (!domain && !queryUrl) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, \"NO URL\", {\n ...urlOptions,\n });\n\n // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n }\n\n // -------------------------- url 구성; start\n\n // 백엔드 요청 URL\n const url = generateQueryUrl({ ...urlOptions, method });\n if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n // -------------------------- url 구성; end\n\n // -------------------------- debug headers 구성; start\n\n const headerOptions: HeadersInit = {\n // 외부에서 전달된 헤더\n ...headers,\n // 백엔드 디버깅용 헤더 추가\n \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n \"Uniai-Native-Domain\": domain,\n \"Uniai-Native-Path\": queryUrl,\n };\n\n // 백엔드 요청 URL 전체\n const nativeUrl = `${domain \|\| \"\"}${queryUrl \|\| \"\"}${getQueryString(urlOptions.searchParams)}`;\n Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n // -------------------------- debug headers 구성; end\n\n // -------------------------- authorization token 구성; start\n\n // 인증 토큰 추가\n // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n const requestHeaders = disabledToken\n ? new Headers(headerOptions)\n : await setTokenRequestHeaders(headerOptions);\n\n if (!disabledLog) {\n nextAPILog(method, routeUrl, url, {\n disabledToken,\n headers: headerOptions,\n headerWithToken: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n });\n }\n\n // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n if (!disabledToken && !requestHeaders) {\n // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n }\n\n // -------------------------- authorization token 구성; end\n\n // -------------------------- fetch options 구성; start\n\n const fetchOptions: API_GetFetchOptionsParams = {\n method,\n headers: requestHeaders,\n };\n\n // body 데이터 구성\n if (method !== \"GET\" && bodyData !== undefined) {\n if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });\n\n const stringifyData = convertObjectToSearchParams(bodyData, {\n method,\n urlOptions,\n }).toString();\n if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });\n\n if (stringifyData) {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n Object.assign(fetchOptions, {\n body: [\"string\", \"number\"].includes(typeof bodyData)\n ? String(bodyData)\n : JSON.stringify(bodyData),\n });\n } else {\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n }\n }\n\n // -------------------------- fetch options 구성; end\n\n // -------------------------- fetch 실행; start\n if (!disabledLog)\n nextAPILog(method, routeUrl, url, {\n fetchOptions: {\n ...fetchOptions,\n headers: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n },\n });\n return await fetch(url, getFetchOptions(fetchOptions));\n // -------------------------- fetch 실행; end\n}\n\n/\n 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams \| object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n /\nexport async function setDebugResponseHeaders<ResponseData>({\n res,\n domain,\n queryUrl,\n queryString,\n searchParams,\n fullUrl,\n options,\n}: {\n /\n fetch 응답 데이터\n /\n res: ResponseData;\n /\n API 도메인\n * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n /\n domain: string;\n /\n API 엔드포인트 쿼리 path\n /\n queryUrl: string;\n} & Partial<{\n /\n 쿼리스트링\n /\n queryString: string;\n /\n URLSearchParams 객체\n /\n searchParams: URLSearchParams \| object;\n /\n 전체 URL\n /\n fullUrl: string;\n /\n 응답 옵션\n /\n options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n const hasInvalidStatusText =\n typeof options?.statusText === \"string\" &&\n Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n const response = NextResponse.json(\n res,\n hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n );\n\n response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n response.headers.set(\"Uniai-Native-Domain\", domain);\n response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n const url =\n fullUrl \|\|\n `${domain \|\| \"\"}${queryUrl \|\| \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n response.headers.set(\"Uniai-Native-URL\", url);\n\n return response;\n}\n","import type { API_Res_Base } from \"./types\";\n\nexport const setAlternateResponse = <ResponseDataType>(\n errorMessage: string,\n data: ResponseDataType,\n): API_Res_Base<ResponseDataType> => ({\n status: \"fail\",\n errors: [\n { field_name: \"\", message: errorMessage \|\| \"데이터 조회에 실패했습니다.\" },\n ],\n data,\n});\n","import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n API_FetchWithBodyParams,\n API_GetFetchOptionsParams,\n API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/\n API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n /\nexport const getQueryString = (searchParams?: unknown): string => {\n // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n const serialized = convertObjectToSearchParams(searchParams).toString();\n return serialized ? `?${serialized}` : \"\";\n};\n\n/\n API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query URL\n * @param {unknown[]} messages 로그 메시지\n /\nexport const nextAPILog = (\n method: string,\n routeUrl: string,\n queryUrl?: string,\n ...messages: unknown[]\n) => {\n // 2026-03-19: 배포 환경에서의 모니터링 및 디버깅을 위한 서버 로그 확인을 위해 주석처리함\n // if (process.env.NODE_ENV === \"production\") {\n // return;\n // }\n\n // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n const date = new Date();\n const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n const requestMethod = method.split(\"-\")[0]?.toUpperCase() \|\| \"-\";\n const responseMethod = method.split(\"-\")[1]?.toUpperCase() \|\| requestMethod;\n\n return console.log(\n `\\n`,\n `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n `\\n λ [${requestMethod}] FE route`,\n `\\n ${routeUrl}`,\n ...(queryUrl\n ? [`\\n ═⏵ Ω [${responseMethod}] BE url`, `\\n ${queryUrl}`, `\\n`]\n : []),\n ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n `\\n`,\n );\n};\n\n/\n API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams \| object} [searchParams] 쿼리스트링 원본\n /\nexport const getRouteUrl = (\n routeUrl: string,\n searchParams?: URLSearchParams \| object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/\n API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n /\nexport const generateQueryUrl = ({\n method = \"GET\",\n domain,\n routeUrl,\n queryUrl,\n searchParams,\n log,\n logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n if (!logDisabled) {\n nextAPILog(method, routeUrl, url, {\n ...(log ?? {}),\n ...(searchParams ?? {}),\n });\n }\n\n return url;\n};\n\n/\n API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit \| null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n * method: \"POST\",\n * headers: { \"Content-Type\": \"application/json\" },\n * body: JSON.stringify({ farm_id: 1 }),\n * });\n /\nexport const getFetchOptions = ({\n method,\n headers,\n body,\n}: API_GetFetchOptionsParams): RequestInit => ({\n method,\n // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\n ...(typeof headers === \"undefined\" ? {} : { headers }),\n ...(typeof body === \"undefined\" ? {} : { body }),\n});\n\n/\n API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams \| object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit \| null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\n */\nexport const fetchWithBody = async <\n BodyDataType = object,\n ResponseType extends object \| Response = Response,\n>({\n domain,\n method,\n routeUrl,\n queryUrl,\n searchParams,\n headers,\n body,\n bodyData,\n isRawResponse,\n alternateResponse,\n debug,\n disabled,\n disabledLog,\n}: API_FetchWithBodyParams<\n BodyDataType,\n ResponseType\n>): Promise<ResponseType> => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n const option = getFetchOptions({ method, headers, body });\n\n if (!body && typeof bodyData !== \"undefined\") {\n // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n const bodyParams = convertObjectToSearchParams(bodyData).toString();\n if (bodyParams === \"\") {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (BODY - DATA)\",\n error: \"데이터가 유효하지 않습니다.\",\n bodyData,\n ...(debug ?? {}),\n });\n return alternateResponse;\n }\n option.body = bodyData as BodyInit;\n }\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"READY\",\n ...option,\n ...(debug ?? {}),\n });\n }\n\n if (disabled) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"FETCH DISABLED\",\n message: \"API 요청제한 활성화됨.\",\n });\n return alternateResponse;\n }\n\n try {\n const responseRaw = await fetch(url, option);\n const responseCode = responseRaw.status;\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n code: responseCode,\n });\n }\n\n if (isRawResponse) {\n return responseRaw as ResponseType;\n }\n return (await responseRaw.json()) as ResponseType;\n } catch (error: unknown) {\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (RESPONSE)\",\n error,\n ...(debug ?? {}),\n });\n }\n return alternateResponse;\n }\n};\n"],"mappings":"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","names":["headers","convertObjectToSearchParams","headers"]}

package/package.json CHANGED Viewed

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