@uniai-fe/util-next 0.2.11 → 0.2.13
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.
- package/dist/index.cjs +46 -22
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +6 -2
- package/dist/index.d.ts +6 -2
- package/dist/index.mjs +46 -22
- package/dist/index.mjs.map +1 -1
- package/dist/server/index.cjs +46 -22
- package/dist/server/index.cjs.map +1 -1
- package/dist/server/index.d.cts +6 -2
- package/dist/server/index.d.ts +6 -2
- package/dist/server/index.mjs +46 -22
- package/dist/server/index.mjs.map +1 -1
- package/package.json +1 -1
package/dist/index.cjs
CHANGED
|
@@ -60,34 +60,53 @@ var getFetchOptions = ({
|
|
|
60
60
|
...typeof headers2 === "undefined" ? {} : { headers: headers2 },
|
|
61
61
|
...typeof body === "undefined" ? {} : { body }
|
|
62
62
|
});
|
|
63
|
-
async function setTokenRequestHeaders(headerOptions) {
|
|
63
|
+
async function setTokenRequestHeaders(headerOptions, disabledLog = true) {
|
|
64
|
+
if (!disabledLog)
|
|
65
|
+
console.log(
|
|
66
|
+
"[setTokenRequestHeaders] headerOptions:",
|
|
67
|
+
Object.fromEntries(new Headers(headerOptions))
|
|
68
|
+
);
|
|
64
69
|
const nextHeaders = await headers.headers();
|
|
65
70
|
const headerToken = nextHeaders.get("Authorization") || "";
|
|
66
71
|
const cookieToken = (await headers.cookies()).get("token")?.value || "";
|
|
72
|
+
if (!disabledLog)
|
|
73
|
+
console.log("[setTokenRequestHeaders] token:", {
|
|
74
|
+
headers: headerToken,
|
|
75
|
+
cookie: cookieToken
|
|
76
|
+
});
|
|
67
77
|
const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : "");
|
|
78
|
+
if (!disabledLog) console.log("[setTokenRequestHeaders] final token:", token);
|
|
68
79
|
if (!token) return void 0;
|
|
69
|
-
|
|
80
|
+
const res = new Headers({
|
|
70
81
|
Authorization: token,
|
|
71
82
|
// Bearer 포함됨
|
|
72
83
|
...headerOptions
|
|
73
84
|
});
|
|
85
|
+
if (!disabledLog)
|
|
86
|
+
console.log(
|
|
87
|
+
"[setTokenRequestHeaders] final headers:",
|
|
88
|
+
Object.fromEntries(res)
|
|
89
|
+
);
|
|
90
|
+
return res;
|
|
74
91
|
}
|
|
75
92
|
async function authorizedFetch({
|
|
76
93
|
method = "GET",
|
|
77
94
|
disabledToken,
|
|
78
95
|
urlOptions,
|
|
79
96
|
headers: headers2,
|
|
80
|
-
bodyData
|
|
97
|
+
bodyData,
|
|
98
|
+
disabledLog
|
|
81
99
|
}) {
|
|
82
100
|
const { domain, routeUrl, queryUrl } = urlOptions;
|
|
83
101
|
if (!domain && !queryUrl) {
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
102
|
+
if (!disabledLog)
|
|
103
|
+
nextAPILog(method, routeUrl, "NO URL", {
|
|
104
|
+
...urlOptions
|
|
105
|
+
});
|
|
87
106
|
throw new Error("API \uB3C4\uBA54\uC778 \uB610\uB294 \uACBD\uB85C\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
|
|
88
107
|
}
|
|
89
108
|
const url = generateQueryUrl({ ...urlOptions, method });
|
|
90
|
-
nextAPILog(method, routeUrl, url, { ...urlOptions });
|
|
109
|
+
if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });
|
|
91
110
|
const headerOptions = {
|
|
92
111
|
// 외부에서 전달된 헤더
|
|
93
112
|
...headers2,
|
|
@@ -99,11 +118,13 @@ async function authorizedFetch({
|
|
|
99
118
|
const nativeUrl = `${domain || ""}${queryUrl || ""}${getQueryString(urlOptions.searchParams)}`;
|
|
100
119
|
Object.assign(headerOptions, { "Uniai-Native-URL": nativeUrl });
|
|
101
120
|
const requestHeaders = disabledToken ? new Headers(headerOptions) : await setTokenRequestHeaders(headerOptions);
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
121
|
+
if (!disabledLog) {
|
|
122
|
+
nextAPILog(method, routeUrl, url, {
|
|
123
|
+
disabledToken,
|
|
124
|
+
headers: headerOptions,
|
|
125
|
+
headerWithToken: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
|
|
126
|
+
});
|
|
127
|
+
}
|
|
107
128
|
if (!disabledToken && !requestHeaders) {
|
|
108
129
|
throw new Error("\uC778\uC99D \uC815\uBCF4\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
|
|
109
130
|
}
|
|
@@ -112,24 +133,27 @@ async function authorizedFetch({
|
|
|
112
133
|
headers: requestHeaders
|
|
113
134
|
};
|
|
114
135
|
if (method !== "GET" && bodyData !== void 0) {
|
|
115
|
-
nextAPILog(method, routeUrl, url, { bodyData });
|
|
136
|
+
if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });
|
|
116
137
|
const stringifyData = utilFunctions.convertObjectToSearchParams(bodyData).toString();
|
|
117
|
-
nextAPILog(method, routeUrl, url, { stringifyData });
|
|
138
|
+
if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });
|
|
118
139
|
if (stringifyData) {
|
|
119
|
-
|
|
140
|
+
if (!disabledLog)
|
|
141
|
+
nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC788\uC74C" });
|
|
120
142
|
Object.assign(fetchOptions, {
|
|
121
143
|
body: ["string", "number"].includes(typeof bodyData) ? String(bodyData) : JSON.stringify(bodyData)
|
|
122
144
|
});
|
|
123
145
|
} else {
|
|
124
|
-
|
|
146
|
+
if (!disabledLog)
|
|
147
|
+
nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC5C6\uC74C" });
|
|
125
148
|
}
|
|
126
149
|
}
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
150
|
+
if (!disabledLog)
|
|
151
|
+
nextAPILog(method, routeUrl, url, {
|
|
152
|
+
fetchOptions: {
|
|
153
|
+
...fetchOptions,
|
|
154
|
+
headers: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
|
|
155
|
+
}
|
|
156
|
+
});
|
|
133
157
|
return await fetch(url, getFetchOptions(fetchOptions));
|
|
134
158
|
}
|
|
135
159
|
async function setDebugResponseHeaders({
|
package/dist/index.cjs.map
CHANGED
|
@@ -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 * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n *\n * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n */\nexport async function setTokenRequestHeaders(\n headerOptions?: HeadersInit,\n): Promise<HeadersInit | undefined> {\n const nextHeaders = await headers();\n const headerToken = nextHeaders.get(\"Authorization\") || \"\";\n const cookieToken = (await cookies()).get(\"token\")?.value || \"\";\n // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n if (!token) return undefined;\n\n return new Headers({\n Authorization: token, // Bearer 포함됨\n ...headerOptions,\n });\n}\n\n/**\n * 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @returns {Promise<Response>} fetch 응답 객체\n */\nexport async function authorizedFetch({\n method = \"GET\",\n disabledToken,\n urlOptions,\n headers,\n bodyData,\n}: {\n method?: string;\n disabledToken?: boolean;\n urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n headers?: HeadersInit;\n bodyData?: object;\n}): Promise<Response> {\n const { domain, routeUrl, queryUrl } = urlOptions;\n\n // 기초 데이터 검증\n if (!domain && !queryUrl) {\n nextAPILog(method, routeUrl, \"NO URL\", {\n ...urlOptions,\n });\n\n // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n }\n\n // -------------------------- url 구성; start\n\n // 백엔드 요청 URL\n const url = generateQueryUrl({ ...urlOptions, method });\n nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n // -------------------------- url 구성; end\n\n // -------------------------- debug headers 구성; start\n\n const headerOptions: HeadersInit = {\n // 외부에서 전달된 헤더\n ...headers,\n // 백엔드 디버깅용 헤더 추가\n \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n \"Uniai-Native-Domain\": domain,\n \"Uniai-Native-Path\": queryUrl,\n };\n\n // 백엔드 요청 URL 전체\n const nativeUrl = `${domain || \"\"}${queryUrl || \"\"}${getQueryString(urlOptions.searchParams)}`;\n Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n // -------------------------- debug headers 구성; end\n\n // -------------------------- authorization token 구성; start\n\n // 인증 토큰 추가\n // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n const requestHeaders = disabledToken\n ? new Headers(headerOptions)\n : await setTokenRequestHeaders(headerOptions);\n\n nextAPILog(method, routeUrl, url, {\n disabledToken,\n headerOptions,\n requestHeaders: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n });\n\n // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n if (!disabledToken && !requestHeaders) {\n // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n }\n\n // -------------------------- authorization token 구성; end\n\n // -------------------------- fetch options 구성; start\n\n const fetchOptions: API_GetFetchOptionsParams = {\n method,\n headers: requestHeaders,\n };\n\n // body 데이터 구성\n if (method !== \"GET\" && bodyData !== undefined) {\n nextAPILog(method, routeUrl, url, { bodyData });\n\n const stringifyData = convertObjectToSearchParams(bodyData).toString();\n nextAPILog(method, routeUrl, url, { stringifyData });\n\n if (stringifyData) {\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n Object.assign(fetchOptions, {\n body: [\"string\", \"number\"].includes(typeof bodyData)\n ? String(bodyData)\n : JSON.stringify(bodyData),\n });\n } else {\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n }\n }\n\n // -------------------------- fetch options 구성; end\n\n // -------------------------- fetch 실행; start\n nextAPILog(method, routeUrl, url, {\n fetchOptions: {\n ...fetchOptions,\n headers: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n },\n });\n return await fetch(url, getFetchOptions(fetchOptions));\n // -------------------------- fetch 실행; end\n}\n\n/**\n * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n */\nexport async function setDebugResponseHeaders<ResponseData>({\n res,\n domain,\n queryUrl,\n queryString,\n searchParams,\n fullUrl,\n options,\n}: {\n /**\n * fetch 응답 데이터\n */\n res: ResponseData;\n /**\n * API 도메인\n * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n */\n domain: string;\n /**\n * API 엔드포인트 쿼리 path\n */\n queryUrl: string;\n} & Partial<{\n /**\n * 쿼리스트링\n */\n queryString: string;\n /**\n * URLSearchParams 객체\n */\n searchParams: URLSearchParams | object;\n /**\n * 전체 URL\n */\n fullUrl: string;\n /**\n * 응답 옵션\n */\n options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n const hasInvalidStatusText =\n typeof options?.statusText === \"string\" &&\n Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n const response = NextResponse.json(\n res,\n hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n );\n\n response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n response.headers.set(\"Uniai-Native-Domain\", domain);\n response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n const url =\n fullUrl ||\n `${domain || \"\"}${queryUrl || \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n response.headers.set(\"Uniai-Native-URL\", url);\n\n return response;\n}\n","import type { NextResponse } from \"next/server\";\nimport {\n checkResponsiveDevice,\n checkAppleDevice,\n} from \"@uniai-fe/util-functions\";\n\n/**\n * 감지된 기기 환경 저장\n */\nexport function setViewportDeviceInfo(\n response: NextResponse,\n userAgent: string,\n): NextResponse {\n const responseUpdate = response;\n\n // 접속 디바이스의 브레이크 포인트 체크\n responseUpdate.headers.set(\n \"X-Responsive-Device\",\n checkResponsiveDevice(userAgent),\n );\n\n // 접속 디바이스의 애플 기기 여부 체크\n responseUpdate.headers.set(\n \"X-Apple-Device\",\n checkAppleDevice(userAgent) ? \"true\" : \"false\",\n );\n\n return responseUpdate;\n}\n"]}
|
|
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"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -4,6 +4,8 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
|
|
|
4
4
|
/**
|
|
5
5
|
* 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.
|
|
6
6
|
* @see middleware.ts
|
|
7
|
+
* @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)
|
|
8
|
+
* @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)
|
|
7
9
|
* @remarks
|
|
8
10
|
* - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.
|
|
9
11
|
* - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.
|
|
@@ -11,7 +13,7 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
|
|
|
11
13
|
*
|
|
12
14
|
* @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined
|
|
13
15
|
*/
|
|
14
|
-
declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<HeadersInit | undefined>;
|
|
16
|
+
declare function setTokenRequestHeaders(headerOptions?: HeadersInit, disabledLog?: boolean): Promise<HeadersInit | undefined>;
|
|
15
17
|
/**
|
|
16
18
|
* 인증토큰과 결합한 fetch
|
|
17
19
|
* @util
|
|
@@ -20,14 +22,16 @@ declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<He
|
|
|
20
22
|
* @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체
|
|
21
23
|
* @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)
|
|
22
24
|
* @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체
|
|
25
|
+
* @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)
|
|
23
26
|
* @returns {Promise<Response>} fetch 응답 객체
|
|
24
27
|
*/
|
|
25
|
-
declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, }: {
|
|
28
|
+
declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, disabledLog, }: {
|
|
26
29
|
method?: string;
|
|
27
30
|
disabledToken?: boolean;
|
|
28
31
|
urlOptions: Omit<API_GenerateQueryUrlParams, "method">;
|
|
29
32
|
headers?: HeadersInit;
|
|
30
33
|
bodyData?: object;
|
|
34
|
+
disabledLog?: boolean;
|
|
31
35
|
}): Promise<Response>;
|
|
32
36
|
/**
|
|
33
37
|
* 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정
|
package/dist/index.d.ts
CHANGED
|
@@ -4,6 +4,8 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
|
|
|
4
4
|
/**
|
|
5
5
|
* 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.
|
|
6
6
|
* @see middleware.ts
|
|
7
|
+
* @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)
|
|
8
|
+
* @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)
|
|
7
9
|
* @remarks
|
|
8
10
|
* - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.
|
|
9
11
|
* - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.
|
|
@@ -11,7 +13,7 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
|
|
|
11
13
|
*
|
|
12
14
|
* @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined
|
|
13
15
|
*/
|
|
14
|
-
declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<HeadersInit | undefined>;
|
|
16
|
+
declare function setTokenRequestHeaders(headerOptions?: HeadersInit, disabledLog?: boolean): Promise<HeadersInit | undefined>;
|
|
15
17
|
/**
|
|
16
18
|
* 인증토큰과 결합한 fetch
|
|
17
19
|
* @util
|
|
@@ -20,14 +22,16 @@ declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<He
|
|
|
20
22
|
* @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체
|
|
21
23
|
* @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)
|
|
22
24
|
* @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체
|
|
25
|
+
* @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)
|
|
23
26
|
* @returns {Promise<Response>} fetch 응답 객체
|
|
24
27
|
*/
|
|
25
|
-
declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, }: {
|
|
28
|
+
declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, disabledLog, }: {
|
|
26
29
|
method?: string;
|
|
27
30
|
disabledToken?: boolean;
|
|
28
31
|
urlOptions: Omit<API_GenerateQueryUrlParams, "method">;
|
|
29
32
|
headers?: HeadersInit;
|
|
30
33
|
bodyData?: object;
|
|
34
|
+
disabledLog?: boolean;
|
|
31
35
|
}): Promise<Response>;
|
|
32
36
|
/**
|
|
33
37
|
* 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정
|
package/dist/index.mjs
CHANGED
|
@@ -58,34 +58,53 @@ var getFetchOptions = ({
|
|
|
58
58
|
...typeof headers2 === "undefined" ? {} : { headers: headers2 },
|
|
59
59
|
...typeof body === "undefined" ? {} : { body }
|
|
60
60
|
});
|
|
61
|
-
async function setTokenRequestHeaders(headerOptions) {
|
|
61
|
+
async function setTokenRequestHeaders(headerOptions, disabledLog = true) {
|
|
62
|
+
if (!disabledLog)
|
|
63
|
+
console.log(
|
|
64
|
+
"[setTokenRequestHeaders] headerOptions:",
|
|
65
|
+
Object.fromEntries(new Headers(headerOptions))
|
|
66
|
+
);
|
|
62
67
|
const nextHeaders = await headers();
|
|
63
68
|
const headerToken = nextHeaders.get("Authorization") || "";
|
|
64
69
|
const cookieToken = (await cookies()).get("token")?.value || "";
|
|
70
|
+
if (!disabledLog)
|
|
71
|
+
console.log("[setTokenRequestHeaders] token:", {
|
|
72
|
+
headers: headerToken,
|
|
73
|
+
cookie: cookieToken
|
|
74
|
+
});
|
|
65
75
|
const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : "");
|
|
76
|
+
if (!disabledLog) console.log("[setTokenRequestHeaders] final token:", token);
|
|
66
77
|
if (!token) return void 0;
|
|
67
|
-
|
|
78
|
+
const res = new Headers({
|
|
68
79
|
Authorization: token,
|
|
69
80
|
// Bearer 포함됨
|
|
70
81
|
...headerOptions
|
|
71
82
|
});
|
|
83
|
+
if (!disabledLog)
|
|
84
|
+
console.log(
|
|
85
|
+
"[setTokenRequestHeaders] final headers:",
|
|
86
|
+
Object.fromEntries(res)
|
|
87
|
+
);
|
|
88
|
+
return res;
|
|
72
89
|
}
|
|
73
90
|
async function authorizedFetch({
|
|
74
91
|
method = "GET",
|
|
75
92
|
disabledToken,
|
|
76
93
|
urlOptions,
|
|
77
94
|
headers: headers2,
|
|
78
|
-
bodyData
|
|
95
|
+
bodyData,
|
|
96
|
+
disabledLog
|
|
79
97
|
}) {
|
|
80
98
|
const { domain, routeUrl, queryUrl } = urlOptions;
|
|
81
99
|
if (!domain && !queryUrl) {
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
100
|
+
if (!disabledLog)
|
|
101
|
+
nextAPILog(method, routeUrl, "NO URL", {
|
|
102
|
+
...urlOptions
|
|
103
|
+
});
|
|
85
104
|
throw new Error("API \uB3C4\uBA54\uC778 \uB610\uB294 \uACBD\uB85C\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
|
|
86
105
|
}
|
|
87
106
|
const url = generateQueryUrl({ ...urlOptions, method });
|
|
88
|
-
nextAPILog(method, routeUrl, url, { ...urlOptions });
|
|
107
|
+
if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });
|
|
89
108
|
const headerOptions = {
|
|
90
109
|
// 외부에서 전달된 헤더
|
|
91
110
|
...headers2,
|
|
@@ -97,11 +116,13 @@ async function authorizedFetch({
|
|
|
97
116
|
const nativeUrl = `${domain || ""}${queryUrl || ""}${getQueryString(urlOptions.searchParams)}`;
|
|
98
117
|
Object.assign(headerOptions, { "Uniai-Native-URL": nativeUrl });
|
|
99
118
|
const requestHeaders = disabledToken ? new Headers(headerOptions) : await setTokenRequestHeaders(headerOptions);
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
119
|
+
if (!disabledLog) {
|
|
120
|
+
nextAPILog(method, routeUrl, url, {
|
|
121
|
+
disabledToken,
|
|
122
|
+
headers: headerOptions,
|
|
123
|
+
headerWithToken: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
|
|
124
|
+
});
|
|
125
|
+
}
|
|
105
126
|
if (!disabledToken && !requestHeaders) {
|
|
106
127
|
throw new Error("\uC778\uC99D \uC815\uBCF4\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
|
|
107
128
|
}
|
|
@@ -110,24 +131,27 @@ async function authorizedFetch({
|
|
|
110
131
|
headers: requestHeaders
|
|
111
132
|
};
|
|
112
133
|
if (method !== "GET" && bodyData !== void 0) {
|
|
113
|
-
nextAPILog(method, routeUrl, url, { bodyData });
|
|
134
|
+
if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });
|
|
114
135
|
const stringifyData = convertObjectToSearchParams(bodyData).toString();
|
|
115
|
-
nextAPILog(method, routeUrl, url, { stringifyData });
|
|
136
|
+
if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });
|
|
116
137
|
if (stringifyData) {
|
|
117
|
-
|
|
138
|
+
if (!disabledLog)
|
|
139
|
+
nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC788\uC74C" });
|
|
118
140
|
Object.assign(fetchOptions, {
|
|
119
141
|
body: ["string", "number"].includes(typeof bodyData) ? String(bodyData) : JSON.stringify(bodyData)
|
|
120
142
|
});
|
|
121
143
|
} else {
|
|
122
|
-
|
|
144
|
+
if (!disabledLog)
|
|
145
|
+
nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC5C6\uC74C" });
|
|
123
146
|
}
|
|
124
147
|
}
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
148
|
+
if (!disabledLog)
|
|
149
|
+
nextAPILog(method, routeUrl, url, {
|
|
150
|
+
fetchOptions: {
|
|
151
|
+
...fetchOptions,
|
|
152
|
+
headers: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
|
|
153
|
+
}
|
|
154
|
+
});
|
|
131
155
|
return await fetch(url, getFetchOptions(fetchOptions));
|
|
132
156
|
}
|
|
133
157
|
async function setDebugResponseHeaders({
|
package/dist/index.mjs.map
CHANGED
|
@@ -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 * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n *\n * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n */\nexport async function setTokenRequestHeaders(\n headerOptions?: HeadersInit,\n): Promise<HeadersInit | undefined> {\n const nextHeaders = await headers();\n const headerToken = nextHeaders.get(\"Authorization\") || \"\";\n const cookieToken = (await cookies()).get(\"token\")?.value || \"\";\n // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n if (!token) return undefined;\n\n return new Headers({\n Authorization: token, // Bearer 포함됨\n ...headerOptions,\n });\n}\n\n/**\n * 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @returns {Promise<Response>} fetch 응답 객체\n */\nexport async function authorizedFetch({\n method = \"GET\",\n disabledToken,\n urlOptions,\n headers,\n bodyData,\n}: {\n method?: string;\n disabledToken?: boolean;\n urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n headers?: HeadersInit;\n bodyData?: object;\n}): Promise<Response> {\n const { domain, routeUrl, queryUrl } = urlOptions;\n\n // 기초 데이터 검증\n if (!domain && !queryUrl) {\n nextAPILog(method, routeUrl, \"NO URL\", {\n ...urlOptions,\n });\n\n // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n }\n\n // -------------------------- url 구성; start\n\n // 백엔드 요청 URL\n const url = generateQueryUrl({ ...urlOptions, method });\n nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n // -------------------------- url 구성; end\n\n // -------------------------- debug headers 구성; start\n\n const headerOptions: HeadersInit = {\n // 외부에서 전달된 헤더\n ...headers,\n // 백엔드 디버깅용 헤더 추가\n \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n \"Uniai-Native-Domain\": domain,\n \"Uniai-Native-Path\": queryUrl,\n };\n\n // 백엔드 요청 URL 전체\n const nativeUrl = `${domain || \"\"}${queryUrl || \"\"}${getQueryString(urlOptions.searchParams)}`;\n Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n // -------------------------- debug headers 구성; end\n\n // -------------------------- authorization token 구성; start\n\n // 인증 토큰 추가\n // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n const requestHeaders = disabledToken\n ? new Headers(headerOptions)\n : await setTokenRequestHeaders(headerOptions);\n\n nextAPILog(method, routeUrl, url, {\n disabledToken,\n headerOptions,\n requestHeaders: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n });\n\n // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n if (!disabledToken && !requestHeaders) {\n // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n }\n\n // -------------------------- authorization token 구성; end\n\n // -------------------------- fetch options 구성; start\n\n const fetchOptions: API_GetFetchOptionsParams = {\n method,\n headers: requestHeaders,\n };\n\n // body 데이터 구성\n if (method !== \"GET\" && bodyData !== undefined) {\n nextAPILog(method, routeUrl, url, { bodyData });\n\n const stringifyData = convertObjectToSearchParams(bodyData).toString();\n nextAPILog(method, routeUrl, url, { stringifyData });\n\n if (stringifyData) {\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n Object.assign(fetchOptions, {\n body: [\"string\", \"number\"].includes(typeof bodyData)\n ? String(bodyData)\n : JSON.stringify(bodyData),\n });\n } else {\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n }\n }\n\n // -------------------------- fetch options 구성; end\n\n // -------------------------- fetch 실행; start\n nextAPILog(method, routeUrl, url, {\n fetchOptions: {\n ...fetchOptions,\n headers: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n },\n });\n return await fetch(url, getFetchOptions(fetchOptions));\n // -------------------------- fetch 실행; end\n}\n\n/**\n * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n */\nexport async function setDebugResponseHeaders<ResponseData>({\n res,\n domain,\n queryUrl,\n queryString,\n searchParams,\n fullUrl,\n options,\n}: {\n /**\n * fetch 응답 데이터\n */\n res: ResponseData;\n /**\n * API 도메인\n * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n */\n domain: string;\n /**\n * API 엔드포인트 쿼리 path\n */\n queryUrl: string;\n} & Partial<{\n /**\n * 쿼리스트링\n */\n queryString: string;\n /**\n * URLSearchParams 객체\n */\n searchParams: URLSearchParams | object;\n /**\n * 전체 URL\n */\n fullUrl: string;\n /**\n * 응답 옵션\n */\n options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n const hasInvalidStatusText =\n typeof options?.statusText === \"string\" &&\n Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n const response = NextResponse.json(\n res,\n hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n );\n\n response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n response.headers.set(\"Uniai-Native-Domain\", domain);\n response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n const url =\n fullUrl ||\n `${domain || \"\"}${queryUrl || \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n response.headers.set(\"Uniai-Native-URL\", url);\n\n return response;\n}\n","import type { NextResponse } from \"next/server\";\nimport {\n checkResponsiveDevice,\n checkAppleDevice,\n} from \"@uniai-fe/util-functions\";\n\n/**\n * 감지된 기기 환경 저장\n */\nexport function setViewportDeviceInfo(\n response: NextResponse,\n userAgent: string,\n): NextResponse {\n const responseUpdate = response;\n\n // 접속 디바이스의 브레이크 포인트 체크\n responseUpdate.headers.set(\n \"X-Responsive-Device\",\n checkResponsiveDevice(userAgent),\n );\n\n // 접속 디바이스의 애플 기기 여부 체크\n responseUpdate.headers.set(\n \"X-Apple-Device\",\n checkAppleDevice(userAgent) ? \"true\" : \"false\",\n );\n\n return responseUpdate;\n}\n"]}
|
|
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"]}
|
package/dist/server/index.cjs
CHANGED
|
@@ -90,34 +90,53 @@ var getFetchOptions = ({
|
|
|
90
90
|
|
|
91
91
|
// src/server/module.ts
|
|
92
92
|
var import_util_functions2 = require("@uniai-fe/util-functions");
|
|
93
|
-
async function setTokenRequestHeaders(headerOptions) {
|
|
93
|
+
async function setTokenRequestHeaders(headerOptions, disabledLog = true) {
|
|
94
|
+
if (!disabledLog)
|
|
95
|
+
console.log(
|
|
96
|
+
"[setTokenRequestHeaders] headerOptions:",
|
|
97
|
+
Object.fromEntries(new Headers(headerOptions))
|
|
98
|
+
);
|
|
94
99
|
const nextHeaders = await (0, import_headers.headers)();
|
|
95
100
|
const headerToken = nextHeaders.get("Authorization") || "";
|
|
96
101
|
const cookieToken = (await (0, import_headers.cookies)()).get("token")?.value || "";
|
|
102
|
+
if (!disabledLog)
|
|
103
|
+
console.log("[setTokenRequestHeaders] token:", {
|
|
104
|
+
headers: headerToken,
|
|
105
|
+
cookie: cookieToken
|
|
106
|
+
});
|
|
97
107
|
const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : "");
|
|
108
|
+
if (!disabledLog) console.log("[setTokenRequestHeaders] final token:", token);
|
|
98
109
|
if (!token) return void 0;
|
|
99
|
-
|
|
110
|
+
const res = new Headers({
|
|
100
111
|
Authorization: token,
|
|
101
112
|
// Bearer 포함됨
|
|
102
113
|
...headerOptions
|
|
103
114
|
});
|
|
115
|
+
if (!disabledLog)
|
|
116
|
+
console.log(
|
|
117
|
+
"[setTokenRequestHeaders] final headers:",
|
|
118
|
+
Object.fromEntries(res)
|
|
119
|
+
);
|
|
120
|
+
return res;
|
|
104
121
|
}
|
|
105
122
|
async function authorizedFetch({
|
|
106
123
|
method = "GET",
|
|
107
124
|
disabledToken,
|
|
108
125
|
urlOptions,
|
|
109
126
|
headers: headers2,
|
|
110
|
-
bodyData
|
|
127
|
+
bodyData,
|
|
128
|
+
disabledLog
|
|
111
129
|
}) {
|
|
112
130
|
const { domain, routeUrl, queryUrl } = urlOptions;
|
|
113
131
|
if (!domain && !queryUrl) {
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
132
|
+
if (!disabledLog)
|
|
133
|
+
nextAPILog(method, routeUrl, "NO URL", {
|
|
134
|
+
...urlOptions
|
|
135
|
+
});
|
|
117
136
|
throw new Error("API \uB3C4\uBA54\uC778 \uB610\uB294 \uACBD\uB85C\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
|
|
118
137
|
}
|
|
119
138
|
const url = generateQueryUrl({ ...urlOptions, method });
|
|
120
|
-
nextAPILog(method, routeUrl, url, { ...urlOptions });
|
|
139
|
+
if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });
|
|
121
140
|
const headerOptions = {
|
|
122
141
|
// 외부에서 전달된 헤더
|
|
123
142
|
...headers2,
|
|
@@ -129,11 +148,13 @@ async function authorizedFetch({
|
|
|
129
148
|
const nativeUrl = `${domain || ""}${queryUrl || ""}${getQueryString(urlOptions.searchParams)}`;
|
|
130
149
|
Object.assign(headerOptions, { "Uniai-Native-URL": nativeUrl });
|
|
131
150
|
const requestHeaders = disabledToken ? new Headers(headerOptions) : await setTokenRequestHeaders(headerOptions);
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
151
|
+
if (!disabledLog) {
|
|
152
|
+
nextAPILog(method, routeUrl, url, {
|
|
153
|
+
disabledToken,
|
|
154
|
+
headers: headerOptions,
|
|
155
|
+
headerWithToken: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
|
|
156
|
+
});
|
|
157
|
+
}
|
|
137
158
|
if (!disabledToken && !requestHeaders) {
|
|
138
159
|
throw new Error("\uC778\uC99D \uC815\uBCF4\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
|
|
139
160
|
}
|
|
@@ -142,24 +163,27 @@ async function authorizedFetch({
|
|
|
142
163
|
headers: requestHeaders
|
|
143
164
|
};
|
|
144
165
|
if (method !== "GET" && bodyData !== void 0) {
|
|
145
|
-
nextAPILog(method, routeUrl, url, { bodyData });
|
|
166
|
+
if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });
|
|
146
167
|
const stringifyData = (0, import_util_functions2.convertObjectToSearchParams)(bodyData).toString();
|
|
147
|
-
nextAPILog(method, routeUrl, url, { stringifyData });
|
|
168
|
+
if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });
|
|
148
169
|
if (stringifyData) {
|
|
149
|
-
|
|
170
|
+
if (!disabledLog)
|
|
171
|
+
nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC788\uC74C" });
|
|
150
172
|
Object.assign(fetchOptions, {
|
|
151
173
|
body: ["string", "number"].includes(typeof bodyData) ? String(bodyData) : JSON.stringify(bodyData)
|
|
152
174
|
});
|
|
153
175
|
} else {
|
|
154
|
-
|
|
176
|
+
if (!disabledLog)
|
|
177
|
+
nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC5C6\uC74C" });
|
|
155
178
|
}
|
|
156
179
|
}
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
180
|
+
if (!disabledLog)
|
|
181
|
+
nextAPILog(method, routeUrl, url, {
|
|
182
|
+
fetchOptions: {
|
|
183
|
+
...fetchOptions,
|
|
184
|
+
headers: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
|
|
185
|
+
}
|
|
186
|
+
});
|
|
163
187
|
return await fetch(url, getFetchOptions(fetchOptions));
|
|
164
188
|
}
|
|
165
189
|
async function setDebugResponseHeaders({
|
|
@@ -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 * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n *\n * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n */\nexport async function setTokenRequestHeaders(\n headerOptions?: HeadersInit,\n): Promise<HeadersInit | undefined> {\n const nextHeaders = await headers();\n const headerToken = nextHeaders.get(\"Authorization\") || \"\";\n const cookieToken = (await cookies()).get(\"token\")?.value || \"\";\n // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n if (!token) return undefined;\n\n return new Headers({\n Authorization: token, // Bearer 포함됨\n ...headerOptions,\n });\n}\n\n/**\n * 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @returns {Promise<Response>} fetch 응답 객체\n */\nexport async function authorizedFetch({\n method = \"GET\",\n disabledToken,\n urlOptions,\n headers,\n bodyData,\n}: {\n method?: string;\n disabledToken?: boolean;\n urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n headers?: HeadersInit;\n bodyData?: object;\n}): Promise<Response> {\n const { domain, routeUrl, queryUrl } = urlOptions;\n\n // 기초 데이터 검증\n if (!domain && !queryUrl) {\n nextAPILog(method, routeUrl, \"NO URL\", {\n ...urlOptions,\n });\n\n // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n }\n\n // -------------------------- url 구성; start\n\n // 백엔드 요청 URL\n const url = generateQueryUrl({ ...urlOptions, method });\n nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n // -------------------------- url 구성; end\n\n // -------------------------- debug headers 구성; start\n\n const headerOptions: HeadersInit = {\n // 외부에서 전달된 헤더\n ...headers,\n // 백엔드 디버깅용 헤더 추가\n \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n \"Uniai-Native-Domain\": domain,\n \"Uniai-Native-Path\": queryUrl,\n };\n\n // 백엔드 요청 URL 전체\n const nativeUrl = `${domain || \"\"}${queryUrl || \"\"}${getQueryString(urlOptions.searchParams)}`;\n Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n // -------------------------- debug headers 구성; end\n\n // -------------------------- authorization token 구성; start\n\n // 인증 토큰 추가\n // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n const requestHeaders = disabledToken\n ? new Headers(headerOptions)\n : await setTokenRequestHeaders(headerOptions);\n\n nextAPILog(method, routeUrl, url, {\n disabledToken,\n headerOptions,\n requestHeaders: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n });\n\n // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n if (!disabledToken && !requestHeaders) {\n // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n }\n\n // -------------------------- authorization token 구성; end\n\n // -------------------------- fetch options 구성; start\n\n const fetchOptions: API_GetFetchOptionsParams = {\n method,\n headers: requestHeaders,\n };\n\n // body 데이터 구성\n if (method !== \"GET\" && bodyData !== undefined) {\n nextAPILog(method, routeUrl, url, { bodyData });\n\n const stringifyData = convertObjectToSearchParams(bodyData).toString();\n nextAPILog(method, routeUrl, url, { stringifyData });\n\n if (stringifyData) {\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n Object.assign(fetchOptions, {\n body: [\"string\", \"number\"].includes(typeof bodyData)\n ? String(bodyData)\n : JSON.stringify(bodyData),\n });\n } else {\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n }\n }\n\n // -------------------------- fetch options 구성; end\n\n // -------------------------- fetch 실행; start\n nextAPILog(method, routeUrl, url, {\n fetchOptions: {\n ...fetchOptions,\n headers: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n },\n });\n return await fetch(url, getFetchOptions(fetchOptions));\n // -------------------------- fetch 실행; end\n}\n\n/**\n * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n */\nexport async function setDebugResponseHeaders<ResponseData>({\n res,\n domain,\n queryUrl,\n queryString,\n searchParams,\n fullUrl,\n options,\n}: {\n /**\n * fetch 응답 데이터\n */\n res: ResponseData;\n /**\n * API 도메인\n * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n */\n domain: string;\n /**\n * API 엔드포인트 쿼리 path\n */\n queryUrl: string;\n} & Partial<{\n /**\n * 쿼리스트링\n */\n queryString: string;\n /**\n * URLSearchParams 객체\n */\n searchParams: URLSearchParams | object;\n /**\n * 전체 URL\n */\n fullUrl: string;\n /**\n * 응답 옵션\n */\n options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n const hasInvalidStatusText =\n typeof options?.statusText === \"string\" &&\n Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n const response = NextResponse.json(\n res,\n hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n );\n\n response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n response.headers.set(\"Uniai-Native-Domain\", domain);\n response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n const url =\n fullUrl ||\n `${domain || \"\"}${queryUrl || \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n response.headers.set(\"Uniai-Native-URL\", url);\n\n return response;\n}\n","import type { API_Res_Base } from \"./types\";\n\nexport const setAlternateResponse = <ResponseDataType>(\n errorMessage: string,\n data: ResponseDataType,\n): API_Res_Base<ResponseDataType> => ({\n status: \"fail\",\n errors: [\n { field_name: \"\", message: errorMessage || \"데이터 조회에 실패했습니다.\" },\n ],\n data,\n});\n","import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n API_FetchWithBodyParams,\n API_GetFetchOptionsParams,\n API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/**\n * API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n */\nexport const getQueryString = (searchParams?: unknown): string => {\n // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n const serialized = convertObjectToSearchParams(searchParams).toString();\n return serialized ? `?${serialized}` : \"\";\n};\n\n/**\n * API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query URL\n * @param {unknown[]} messages 로그 메시지\n */\nexport const nextAPILog = (\n method: string,\n routeUrl: string,\n queryUrl?: string,\n ...messages: unknown[]\n) => {\n // 2026-03-19: 배포 환경에서의 모니터링 및 디버깅을 위한 서버 로그 확인을 위해 주석처리함\n // if (process.env.NODE_ENV === \"production\") {\n // return;\n // }\n\n // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n const date = new Date();\n const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n const requestMethod = method.split(\"-\")[0]?.toUpperCase() || \"-\";\n const responseMethod = method.split(\"-\")[1]?.toUpperCase() || requestMethod;\n\n return console.log(\n `\\n`,\n `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n `\\n λ [${requestMethod}] FE route`,\n `\\n ${routeUrl}`,\n ...(queryUrl\n ? [`\\n ═⏵ Ω [${responseMethod}] BE url`, `\\n ${queryUrl}`, `\\n`]\n : []),\n ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n `\\n`,\n );\n};\n\n/**\n * API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams | object} [searchParams] 쿼리스트링 원본\n */\nexport const getRouteUrl = (\n routeUrl: string,\n searchParams?: URLSearchParams | object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/**\n * API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n */\nexport const generateQueryUrl = ({\n method = \"GET\",\n domain,\n routeUrl,\n queryUrl,\n searchParams,\n log,\n logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n if (!logDisabled) {\n nextAPILog(method, routeUrl, url, {\n ...(log ?? {}),\n ...(searchParams ?? {}),\n });\n }\n\n return url;\n};\n\n/**\n * API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit | null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n * method: \"POST\",\n * headers: { \"Content-Type\": \"application/json\" },\n * body: JSON.stringify({ farm_id: 1 }),\n * });\n */\nexport const getFetchOptions = ({\n method,\n headers,\n body,\n}: API_GetFetchOptionsParams): RequestInit => ({\n method,\n // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\n ...(typeof headers === \"undefined\" ? {} : { headers }),\n ...(typeof body === \"undefined\" ? {} : { body }),\n});\n\n/**\n * API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit | null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\n */\nexport const fetchWithBody = async <\n BodyDataType = object,\n ResponseType extends object | Response = Response,\n>({\n domain,\n method,\n routeUrl,\n queryUrl,\n searchParams,\n headers,\n body,\n bodyData,\n isRawResponse,\n alternateResponse,\n debug,\n disabled,\n disabledLog,\n}: API_FetchWithBodyParams<\n BodyDataType,\n ResponseType\n>): Promise<ResponseType> => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n const option = getFetchOptions({ method, headers, body });\n\n if (!body && typeof bodyData !== \"undefined\") {\n // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n const bodyParams = convertObjectToSearchParams(bodyData).toString();\n if (bodyParams === \"\") {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (BODY - DATA)\",\n error: \"데이터가 유효하지 않습니다.\",\n bodyData,\n ...(debug ?? {}),\n });\n return alternateResponse;\n }\n option.body = bodyData as BodyInit;\n }\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"READY\",\n ...option,\n ...(debug ?? {}),\n });\n }\n\n if (disabled) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"FETCH DISABLED\",\n message: \"API 요청제한 활성화됨.\",\n });\n return alternateResponse;\n }\n\n try {\n const responseRaw = await fetch(url, option);\n const responseCode = responseRaw.status;\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n code: responseCode,\n });\n }\n\n if (isRawResponse) {\n return responseRaw as ResponseType;\n }\n return (await responseRaw.json()) as ResponseType;\n } catch (error: unknown) {\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (RESPONSE)\",\n error,\n ...(debug ?? {}),\n });\n }\n return alternateResponse;\n }\n};\n"],"mappings":"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","names":["headers","import_util_functions","headers"]}
|
|
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"]}
|
package/dist/server/index.d.cts
CHANGED
|
@@ -4,6 +4,8 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
|
|
|
4
4
|
/**
|
|
5
5
|
* 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.
|
|
6
6
|
* @see middleware.ts
|
|
7
|
+
* @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)
|
|
8
|
+
* @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)
|
|
7
9
|
* @remarks
|
|
8
10
|
* - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.
|
|
9
11
|
* - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.
|
|
@@ -11,7 +13,7 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
|
|
|
11
13
|
*
|
|
12
14
|
* @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined
|
|
13
15
|
*/
|
|
14
|
-
declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<HeadersInit | undefined>;
|
|
16
|
+
declare function setTokenRequestHeaders(headerOptions?: HeadersInit, disabledLog?: boolean): Promise<HeadersInit | undefined>;
|
|
15
17
|
/**
|
|
16
18
|
* 인증토큰과 결합한 fetch
|
|
17
19
|
* @util
|
|
@@ -20,14 +22,16 @@ declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<He
|
|
|
20
22
|
* @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체
|
|
21
23
|
* @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)
|
|
22
24
|
* @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체
|
|
25
|
+
* @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)
|
|
23
26
|
* @returns {Promise<Response>} fetch 응답 객체
|
|
24
27
|
*/
|
|
25
|
-
declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, }: {
|
|
28
|
+
declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, disabledLog, }: {
|
|
26
29
|
method?: string;
|
|
27
30
|
disabledToken?: boolean;
|
|
28
31
|
urlOptions: Omit<API_GenerateQueryUrlParams, "method">;
|
|
29
32
|
headers?: HeadersInit;
|
|
30
33
|
bodyData?: object;
|
|
34
|
+
disabledLog?: boolean;
|
|
31
35
|
}): Promise<Response>;
|
|
32
36
|
/**
|
|
33
37
|
* 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정
|
package/dist/server/index.d.ts
CHANGED
|
@@ -4,6 +4,8 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
|
|
|
4
4
|
/**
|
|
5
5
|
* 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.
|
|
6
6
|
* @see middleware.ts
|
|
7
|
+
* @param {HeadersInit} [headerOptions] - 추가로 병합할 헤더 옵션 (예: Content-Type 등)
|
|
8
|
+
* @param {boolean} [disabledLog] - true로 설정하면 디버그 로그를 출력하지 않습니다 (기본값: true)
|
|
7
9
|
* @remarks
|
|
8
10
|
* - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.
|
|
9
11
|
* - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.
|
|
@@ -11,7 +13,7 @@ import { API_GenerateQueryUrlParams } from '@uniai-fe/util-api';
|
|
|
11
13
|
*
|
|
12
14
|
* @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined
|
|
13
15
|
*/
|
|
14
|
-
declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<HeadersInit | undefined>;
|
|
16
|
+
declare function setTokenRequestHeaders(headerOptions?: HeadersInit, disabledLog?: boolean): Promise<HeadersInit | undefined>;
|
|
15
17
|
/**
|
|
16
18
|
* 인증토큰과 결합한 fetch
|
|
17
19
|
* @util
|
|
@@ -20,14 +22,16 @@ declare function setTokenRequestHeaders(headerOptions?: HeadersInit): Promise<He
|
|
|
20
22
|
* @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체
|
|
21
23
|
* @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)
|
|
22
24
|
* @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체
|
|
25
|
+
* @property {boolean} [disabledLog] - true로 설정하면 요청과 응답에 대한 디버그 로그 출력 (기본값: false)
|
|
23
26
|
* @returns {Promise<Response>} fetch 응답 객체
|
|
24
27
|
*/
|
|
25
|
-
declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, }: {
|
|
28
|
+
declare function authorizedFetch({ method, disabledToken, urlOptions, headers, bodyData, disabledLog, }: {
|
|
26
29
|
method?: string;
|
|
27
30
|
disabledToken?: boolean;
|
|
28
31
|
urlOptions: Omit<API_GenerateQueryUrlParams, "method">;
|
|
29
32
|
headers?: HeadersInit;
|
|
30
33
|
bodyData?: object;
|
|
34
|
+
disabledLog?: boolean;
|
|
31
35
|
}): Promise<Response>;
|
|
32
36
|
/**
|
|
33
37
|
* 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정
|
package/dist/server/index.mjs
CHANGED
|
@@ -62,34 +62,53 @@ var getFetchOptions = ({
|
|
|
62
62
|
|
|
63
63
|
// src/server/module.ts
|
|
64
64
|
import { convertObjectToSearchParams as convertObjectToSearchParams2 } from "@uniai-fe/util-functions";
|
|
65
|
-
async function setTokenRequestHeaders(headerOptions) {
|
|
65
|
+
async function setTokenRequestHeaders(headerOptions, disabledLog = true) {
|
|
66
|
+
if (!disabledLog)
|
|
67
|
+
console.log(
|
|
68
|
+
"[setTokenRequestHeaders] headerOptions:",
|
|
69
|
+
Object.fromEntries(new Headers(headerOptions))
|
|
70
|
+
);
|
|
66
71
|
const nextHeaders = await headers();
|
|
67
72
|
const headerToken = nextHeaders.get("Authorization") || "";
|
|
68
73
|
const cookieToken = (await cookies()).get("token")?.value || "";
|
|
74
|
+
if (!disabledLog)
|
|
75
|
+
console.log("[setTokenRequestHeaders] token:", {
|
|
76
|
+
headers: headerToken,
|
|
77
|
+
cookie: cookieToken
|
|
78
|
+
});
|
|
69
79
|
const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : "");
|
|
80
|
+
if (!disabledLog) console.log("[setTokenRequestHeaders] final token:", token);
|
|
70
81
|
if (!token) return void 0;
|
|
71
|
-
|
|
82
|
+
const res = new Headers({
|
|
72
83
|
Authorization: token,
|
|
73
84
|
// Bearer 포함됨
|
|
74
85
|
...headerOptions
|
|
75
86
|
});
|
|
87
|
+
if (!disabledLog)
|
|
88
|
+
console.log(
|
|
89
|
+
"[setTokenRequestHeaders] final headers:",
|
|
90
|
+
Object.fromEntries(res)
|
|
91
|
+
);
|
|
92
|
+
return res;
|
|
76
93
|
}
|
|
77
94
|
async function authorizedFetch({
|
|
78
95
|
method = "GET",
|
|
79
96
|
disabledToken,
|
|
80
97
|
urlOptions,
|
|
81
98
|
headers: headers2,
|
|
82
|
-
bodyData
|
|
99
|
+
bodyData,
|
|
100
|
+
disabledLog
|
|
83
101
|
}) {
|
|
84
102
|
const { domain, routeUrl, queryUrl } = urlOptions;
|
|
85
103
|
if (!domain && !queryUrl) {
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
104
|
+
if (!disabledLog)
|
|
105
|
+
nextAPILog(method, routeUrl, "NO URL", {
|
|
106
|
+
...urlOptions
|
|
107
|
+
});
|
|
89
108
|
throw new Error("API \uB3C4\uBA54\uC778 \uB610\uB294 \uACBD\uB85C\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
|
|
90
109
|
}
|
|
91
110
|
const url = generateQueryUrl({ ...urlOptions, method });
|
|
92
|
-
nextAPILog(method, routeUrl, url, { ...urlOptions });
|
|
111
|
+
if (!disabledLog) nextAPILog(method, routeUrl, url, { ...urlOptions });
|
|
93
112
|
const headerOptions = {
|
|
94
113
|
// 외부에서 전달된 헤더
|
|
95
114
|
...headers2,
|
|
@@ -101,11 +120,13 @@ async function authorizedFetch({
|
|
|
101
120
|
const nativeUrl = `${domain || ""}${queryUrl || ""}${getQueryString(urlOptions.searchParams)}`;
|
|
102
121
|
Object.assign(headerOptions, { "Uniai-Native-URL": nativeUrl });
|
|
103
122
|
const requestHeaders = disabledToken ? new Headers(headerOptions) : await setTokenRequestHeaders(headerOptions);
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
123
|
+
if (!disabledLog) {
|
|
124
|
+
nextAPILog(method, routeUrl, url, {
|
|
125
|
+
disabledToken,
|
|
126
|
+
headers: headerOptions,
|
|
127
|
+
headerWithToken: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
|
|
128
|
+
});
|
|
129
|
+
}
|
|
109
130
|
if (!disabledToken && !requestHeaders) {
|
|
110
131
|
throw new Error("\uC778\uC99D \uC815\uBCF4\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
|
|
111
132
|
}
|
|
@@ -114,24 +135,27 @@ async function authorizedFetch({
|
|
|
114
135
|
headers: requestHeaders
|
|
115
136
|
};
|
|
116
137
|
if (method !== "GET" && bodyData !== void 0) {
|
|
117
|
-
nextAPILog(method, routeUrl, url, { bodyData });
|
|
138
|
+
if (!disabledLog) nextAPILog(method, routeUrl, url, { bodyData });
|
|
118
139
|
const stringifyData = convertObjectToSearchParams2(bodyData).toString();
|
|
119
|
-
nextAPILog(method, routeUrl, url, { stringifyData });
|
|
140
|
+
if (!disabledLog) nextAPILog(method, routeUrl, url, { stringifyData });
|
|
120
141
|
if (stringifyData) {
|
|
121
|
-
|
|
142
|
+
if (!disabledLog)
|
|
143
|
+
nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC788\uC74C" });
|
|
122
144
|
Object.assign(fetchOptions, {
|
|
123
145
|
body: ["string", "number"].includes(typeof bodyData) ? String(bodyData) : JSON.stringify(bodyData)
|
|
124
146
|
});
|
|
125
147
|
} else {
|
|
126
|
-
|
|
148
|
+
if (!disabledLog)
|
|
149
|
+
nextAPILog(method, routeUrl, url, { message: "body \uB370\uC774\uD130 \uC5C6\uC74C" });
|
|
127
150
|
}
|
|
128
151
|
}
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
152
|
+
if (!disabledLog)
|
|
153
|
+
nextAPILog(method, routeUrl, url, {
|
|
154
|
+
fetchOptions: {
|
|
155
|
+
...fetchOptions,
|
|
156
|
+
headers: requestHeaders ? Object.fromEntries(new Headers(requestHeaders)) : void 0
|
|
157
|
+
}
|
|
158
|
+
});
|
|
135
159
|
return await fetch(url, getFetchOptions(fetchOptions));
|
|
136
160
|
}
|
|
137
161
|
async function setDebugResponseHeaders({
|
|
@@ -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 * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n *\n * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n */\nexport async function setTokenRequestHeaders(\n headerOptions?: HeadersInit,\n): Promise<HeadersInit | undefined> {\n const nextHeaders = await headers();\n const headerToken = nextHeaders.get(\"Authorization\") || \"\";\n const cookieToken = (await cookies()).get(\"token\")?.value || \"\";\n // 변경: middleware request override가 누락되는 환경에서도 httpOnly token 쿠키를 직접 fallback으로 사용한다.\n const token = headerToken || (cookieToken ? `Bearer ${cookieToken}` : \"\");\n\n if (!token) return undefined;\n\n return new Headers({\n Authorization: token, // Bearer 포함됨\n ...headerOptions,\n });\n}\n\n/**\n * 인증토큰과 결합한 fetch\n * @util\n * @property {string} [method] - HTTP 메서드 (GET, POST, PUT, PATCH, DELETE 등)\n * @property {boolean} disabledToken - true로 설정하면 인증 토큰 없이 요청 (기본값: false)\n * @property {API_GenerateQueryUrlParams} urlOptions - generateQueryUrl에 필요한 옵션 객체\n * @property {HeadersInit} [headers] - 추가적인 헤더 정보 (Authorization 헤더는 setTokenRequestHeaders에서 자동으로 처리)\n * @property {object} [bodyData] - GET이 아닌 메서드에서 요청 바디로 사용할 데이터 객체\n * @returns {Promise<Response>} fetch 응답 객체\n */\nexport async function authorizedFetch({\n method = \"GET\",\n disabledToken,\n urlOptions,\n headers,\n bodyData,\n}: {\n method?: string;\n disabledToken?: boolean;\n urlOptions: Omit<API_GenerateQueryUrlParams, \"method\">;\n headers?: HeadersInit;\n bodyData?: object;\n}): Promise<Response> {\n const { domain, routeUrl, queryUrl } = urlOptions;\n\n // 기초 데이터 검증\n if (!domain && !queryUrl) {\n nextAPILog(method, routeUrl, \"NO URL\", {\n ...urlOptions,\n });\n\n // 변경: 사전 검증 실패는 Response로 돌리지 않고 예외로 올려 route의 기존 try/catch에서 처리한다.\n throw new Error(\"API 도메인 또는 경로가 설정되지 않았습니다.\");\n }\n\n // -------------------------- url 구성; start\n\n // 백엔드 요청 URL\n const url = generateQueryUrl({ ...urlOptions, method });\n nextAPILog(method, routeUrl, url, { ...urlOptions });\n\n // -------------------------- url 구성; end\n\n // -------------------------- debug headers 구성; start\n\n const headerOptions: HeadersInit = {\n // 외부에서 전달된 헤더\n ...headers,\n // 백엔드 디버깅용 헤더 추가\n \"Uniai-Native-Domain-Env-Exist\": String(!!domain),\n \"Uniai-Native-Domain\": domain,\n \"Uniai-Native-Path\": queryUrl,\n };\n\n // 백엔드 요청 URL 전체\n const nativeUrl = `${domain || \"\"}${queryUrl || \"\"}${getQueryString(urlOptions.searchParams)}`;\n Object.assign(headerOptions, { \"Uniai-Native-URL\": nativeUrl });\n\n // -------------------------- debug headers 구성; end\n\n // -------------------------- authorization token 구성; start\n\n // 인증 토큰 추가\n // 변경: disabledToken에서는 토큰만 비활성화하고, 기존 헤더/debug 헤더는 그대로 유지한다.\n const requestHeaders = disabledToken\n ? new Headers(headerOptions)\n : await setTokenRequestHeaders(headerOptions);\n\n nextAPILog(method, routeUrl, url, {\n disabledToken,\n headerOptions,\n requestHeaders: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n });\n\n // Authorization 헤더가 없는 경우, 인증 정보가 없다는 응답을 반환\n if (!disabledToken && !requestHeaders) {\n // 변경: 인증 헤더 누락은 plain text Response 대신 예외로 올려 JSON parse 실패를 막는다.\n throw new Error(\"인증 정보를 확인할 수 없습니다.\");\n }\n\n // -------------------------- authorization token 구성; end\n\n // -------------------------- fetch options 구성; start\n\n const fetchOptions: API_GetFetchOptionsParams = {\n method,\n headers: requestHeaders,\n };\n\n // body 데이터 구성\n if (method !== \"GET\" && bodyData !== undefined) {\n nextAPILog(method, routeUrl, url, { bodyData });\n\n const stringifyData = convertObjectToSearchParams(bodyData).toString();\n nextAPILog(method, routeUrl, url, { stringifyData });\n\n if (stringifyData) {\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 있음\" });\n Object.assign(fetchOptions, {\n body: [\"string\", \"number\"].includes(typeof bodyData)\n ? String(bodyData)\n : JSON.stringify(bodyData),\n });\n } else {\n nextAPILog(method, routeUrl, url, { message: \"body 데이터 없음\" });\n }\n }\n\n // -------------------------- fetch options 구성; end\n\n // -------------------------- fetch 실행; start\n nextAPILog(method, routeUrl, url, {\n fetchOptions: {\n ...fetchOptions,\n headers: requestHeaders\n ? Object.fromEntries(new Headers(requestHeaders))\n : undefined,\n },\n });\n return await fetch(url, getFetchOptions(fetchOptions));\n // -------------------------- fetch 실행; end\n}\n\n/**\n * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n */\nexport async function setDebugResponseHeaders<ResponseData>({\n res,\n domain,\n queryUrl,\n queryString,\n searchParams,\n fullUrl,\n options,\n}: {\n /**\n * fetch 응답 데이터\n */\n res: ResponseData;\n /**\n * API 도메인\n * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n */\n domain: string;\n /**\n * API 엔드포인트 쿼리 path\n */\n queryUrl: string;\n} & Partial<{\n /**\n * 쿼리스트링\n */\n queryString: string;\n /**\n * URLSearchParams 객체\n */\n searchParams: URLSearchParams | object;\n /**\n * 전체 URL\n */\n fullUrl: string;\n /**\n * 응답 옵션\n */\n options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n const hasInvalidStatusText =\n typeof options?.statusText === \"string\" &&\n Array.from(options.statusText).some(char => char.charCodeAt(0) > 255);\n // 변경: Response statusText는 ByteString 제약이 있어 유니코드 메시지는 제거하고 status만 유지한다.\n const response = NextResponse.json(\n res,\n hasInvalidStatusText ? { ...options, statusText: undefined } : options,\n );\n\n response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n response.headers.set(\"Uniai-Native-Domain\", domain);\n response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n const url =\n fullUrl ||\n `${domain || \"\"}${queryUrl || \"\"}${typeof queryString === \"string\" ? queryString : getQueryString(searchParams)}`;\n response.headers.set(\"Uniai-Native-URL\", url);\n\n return response;\n}\n","import type { API_Res_Base } from \"./types\";\n\nexport const setAlternateResponse = <ResponseDataType>(\n errorMessage: string,\n data: ResponseDataType,\n): API_Res_Base<ResponseDataType> => ({\n status: \"fail\",\n errors: [\n { field_name: \"\", message: errorMessage || \"데이터 조회에 실패했습니다.\" },\n ],\n data,\n});\n","import { convertObjectToSearchParams } from \"@uniai-fe/util-functions\";\nimport type {\n API_FetchWithBodyParams,\n API_GetFetchOptionsParams,\n API_GenerateQueryUrlParams,\n} from \"./types\";\n\n/**\n * API Request Utils; 쿼리스트링 생성\n * @param {unknown} [searchParams] 쿼리스트링 변환 대상\n * @returns {string} 직렬화된 쿼리스트링\n * @example\n * const query = getQueryString({ farm_id: 1 });\n */\nexport const getQueryString = (searchParams?: unknown): string => {\n // 변경: util-functions 공통 유틸을 재사용해 query 변환 규칙을 단일화한다.\n const serialized = convertObjectToSearchParams(searchParams).toString();\n return serialized ? `?${serialized}` : \"\";\n};\n\n/**\n * API Request Utils; Next.js route 디버깅 로그 출력\n * @param {string} method HTTP method 문자열\n * @param {string} routeUrl frontend route URL\n * @param {string} [queryUrl] backend query URL\n * @param {unknown[]} messages 로그 메시지\n */\nexport const nextAPILog = (\n method: string,\n routeUrl: string,\n queryUrl?: string,\n ...messages: unknown[]\n) => {\n // 2026-03-19: 배포 환경에서의 모니터링 및 디버깅을 위한 서버 로그 확인을 위해 주석처리함\n // if (process.env.NODE_ENV === \"production\") {\n // return;\n // }\n\n // 변경: util-api 단독 동작을 위해 날짜 포맷 의존성을 내부 계산으로 대체한다.\n const date = new Date();\n const dateText = date.toISOString().split(\"T\")[0] ?? \"\";\n const timeText = `${date.toLocaleTimeString(\"en-US\", { hour12: false })}.${date.getMilliseconds()}`;\n const requestMethod = method.split(\"-\")[0]?.toUpperCase() || \"-\";\n const responseMethod = method.split(\"-\")[1]?.toUpperCase() || requestMethod;\n\n return console.log(\n `\\n`,\n `[Next Server API] ⏱ ${dateText} ( ${timeText} )`,\n `\\n λ [${requestMethod}] FE route`,\n `\\n ${routeUrl}`,\n ...(queryUrl\n ? [`\\n ═⏵ Ω [${responseMethod}] BE url`, `\\n ${queryUrl}`, `\\n`]\n : []),\n ...(messages?.[0] ? [` ◇-`, ...messages] : []),\n `\\n`,\n );\n};\n\n/**\n * API Request Utils; 클라이언트 요청 URL 생성\n * @param {string} routeUrl next.js API URL 또는 요청 경로\n * @param {URLSearchParams | object} [searchParams] 쿼리스트링 원본\n */\nexport const getRouteUrl = (\n routeUrl: string,\n searchParams?: URLSearchParams | object,\n) => `${routeUrl}${getQueryString(searchParams)}`;\n\n/**\n * API Request Utils; GET API 요청 URL 생성\n * @param {API_GenerateQueryUrlParams} params URL 생성 파라미터\n * @property {string} [params.method] fetch HTTP method\n * @property {string} params.domain API 도메인\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {object} [params.log] 디버깅 로그 객체\n * @property {boolean} [params.logDisabled] 로그 비활성화 여부\n * @returns {string} 완성된 요청 URL\n * @example\n * const url = generateQueryUrl({ domain, routeUrl, queryUrl });\n */\nexport const generateQueryUrl = ({\n method = \"GET\",\n domain,\n routeUrl,\n queryUrl,\n searchParams,\n log,\n logDisabled,\n}: API_GenerateQueryUrlParams): string => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n\n if (!logDisabled) {\n nextAPILog(method, routeUrl, url, {\n ...(log ?? {}),\n ...(searchParams ?? {}),\n });\n }\n\n return url;\n};\n\n/**\n * API Request Utils; fetch 요청 옵션 생성\n * @param {API_GetFetchOptionsParams} params 요청 옵션 파라미터\n * @property {string} params.method HTTP method 문자열\n * @property {HeadersInit} [params.headers] 요청 헤더\n * @property {BodyInit | null} [params.body] 요청 body\n * @returns {RequestInit} fetch 요청 옵션 객체\n * @example\n * const option = getFetchOptions({\n * method: \"POST\",\n * headers: { \"Content-Type\": \"application/json\" },\n * body: JSON.stringify({ farm_id: 1 }),\n * });\n */\nexport const getFetchOptions = ({\n method,\n headers,\n body,\n}: API_GetFetchOptionsParams): RequestInit => ({\n method,\n // 변경: Headers 인스턴스는 Object.keys로 비어 보일 수 있어 정의 여부만으로 유지한다.\n ...(typeof headers === \"undefined\" ? {} : { headers }),\n ...(typeof body === \"undefined\" ? {} : { body }),\n});\n\n/**\n * API Request Utils; body 기반 fetch 요청\n * @template BodyDataType\n * @template ResponseType\n * @param {API_FetchWithBodyParams<BodyDataType, ResponseType>} params 요청 파라미터\n * @property {string} params.domain API 도메인\n * @property {string} params.method HTTP method 문자열\n * @property {string} params.routeUrl frontend route URL\n * @property {string} params.queryUrl backend query URL\n * @property {ResponseType} params.alternateResponse 실패 시 대체 응답\n * @property {URLSearchParams | object} [params.searchParams] 쿼리스트링 원본\n * @property {HeadersInit} [params.headers] fetch headers\n * @property {BodyInit | null} [params.body] fetch body\n * @property {BodyDataType} [params.bodyData] body 데이터\n * @property {boolean} [params.isRawResponse] raw response 반환 여부\n * @property {object} [params.debug] 디버그 로그 객체\n * @property {boolean} [params.disabled] fetch 비활성화 여부\n * @property {boolean} [params.disabledLog] 로그 비활성화 여부\n * @returns {Promise<ResponseType>} 응답 데이터 또는 alternateResponse\n * @example\n * const response = await fetchWithBody({ domain, method: \"POST\", routeUrl, queryUrl, alternateResponse });\n */\nexport const fetchWithBody = async <\n BodyDataType = object,\n ResponseType extends object | Response = Response,\n>({\n domain,\n method,\n routeUrl,\n queryUrl,\n searchParams,\n headers,\n body,\n bodyData,\n isRawResponse,\n alternateResponse,\n debug,\n disabled,\n disabledLog,\n}: API_FetchWithBodyParams<\n BodyDataType,\n ResponseType\n>): Promise<ResponseType> => {\n const url = `${domain}${queryUrl}${getQueryString(searchParams)}`;\n const option = getFetchOptions({ method, headers, body });\n\n if (!body && typeof bodyData !== \"undefined\") {\n // 변경: util-functions 공통 유틸을 재사용해 body 직렬화 규칙을 단일화한다.\n const bodyParams = convertObjectToSearchParams(bodyData).toString();\n if (bodyParams === \"\") {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (BODY - DATA)\",\n error: \"데이터가 유효하지 않습니다.\",\n bodyData,\n ...(debug ?? {}),\n });\n return alternateResponse;\n }\n option.body = bodyData as BodyInit;\n }\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"READY\",\n ...option,\n ...(debug ?? {}),\n });\n }\n\n if (disabled) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"FETCH DISABLED\",\n message: \"API 요청제한 활성화됨.\",\n });\n return alternateResponse;\n }\n\n try {\n const responseRaw = await fetch(url, option);\n const responseCode = responseRaw.status;\n\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: responseCode === 200 ? \"SUCCESS\" : \"FAIL\",\n code: responseCode,\n });\n }\n\n if (isRawResponse) {\n return responseRaw as ResponseType;\n }\n return (await responseRaw.json()) as ResponseType;\n } catch (error: unknown) {\n if (!disabledLog) {\n nextAPILog(method.toLowerCase(), routeUrl, url, {\n state: \"ERROR (RESPONSE)\",\n error,\n ...(debug ?? {}),\n });\n }\n return alternateResponse;\n }\n};\n"],"mappings":";AAEA,SAAS,SAAS,eAAe;AACjC,SAAS,oBAAoB;A;;;AEWtB,IAAM,iBAAiB,CAAC,iBAAmC;AAEhE,QAAM,aAAa,4BAA4B,YAAY,EAAE,SAAA;AAC7D,SAAO,aAAa,IAAI,UAAU,KAAK;AACzC;AASO,IAAM,aAAa,CACxB,QACA,UACA,aACG,aACA;AAOH,QAAM,OAAA,oBAAW,KAAA;AACjB,QAAM,WAAW,KAAK,YAAA,EAAc,MAAM,GAAG,EAAE,CAAC,KAAK;AACrD,QAAM,WAAW,GAAG,KAAK,mBAAmB,SAAS,EAAE,QAAQ,MAAA,CAAO,CAAC,IAAI,KAAK,gBAAA,CAAiB;AACjG,QAAM,gBAAgB,OAAO,MAAM,GAAG,EAAE,CAAC,GAAG,YAAA,KAAiB;AAC7D,QAAM,iBAAiB,OAAO,MAAM,GAAG,EAAE,CAAC,GAAG,YAAA,KAAiB;AAE9D,SAAO,QAAQ;IACb;;IACA,4BAAuB,QAAQ,MAAM,QAAQ;IAC7C;YAAU,aAAa;IACvB;KAAQ,QAAQ;IAChB,GAAI,WACA,CAAC;yBAAa,cAAc,YAAY;KAAQ,QAAQ,IAAI;CAAI,IAChE,CAAA;IACJ,GAAI,WAAW,CAAC,IAAI,CAAC,YAAO,GAAG,QAAQ,IAAI,CAAA;IAC3C;;EAAA;AAEJ;AA0BO,IAAM,mBAAmB,CAAC;EAC/B,SAAS;EACT;EACA;EACA;EACA;EACA;EACA;AACF,MAA0C;AACxC,QAAM,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,eAAe,YAAY,CAAC;AAE/D,MAAI,CAAC,aAAa;AAChB,eAAW,QAAQ,UAAU,KAAK;MAChC,GAAI,OAAO,CAAA;MACX,GAAI,gBAAgB,CAAA;IAAC,CACtB;EACH;AAEA,SAAO;AACT;AAgBO,IAAM,kBAAkB,CAAC;EAC9B;EACA,SAAAA;EACA;AACF,OAA+C;EAC7C;;EAEA,GAAI,OAAOA,aAAY,cAAc,CAAA,IAAK,EAAE,SAAAA,SAAA;EAC5C,GAAI,OAAO,SAAS,cAAc,CAAA,IAAK,EAAE,KAAA;AAC3C;;;AFlHA,SAAS,+BAAAC,oCAAmC;AAY5C,eAAsB,uBACpB,eACkC;AAClC,QAAM,cAAc,MAAM,QAAQ;AAClC,QAAM,cAAc,YAAY,IAAI,eAAe,KAAK;AACxD,QAAM,eAAe,MAAM,QAAQ,GAAG,IAAI,OAAO,GAAG,SAAS;AAE7D,QAAM,QAAQ,gBAAgB,cAAc,UAAU,WAAW,KAAK;AAEtE,MAAI,CAAC,MAAO,QAAO;AAEnB,SAAO,IAAI,QAAQ;AAAA,IACjB,eAAe;AAAA;AAAA,IACf,GAAG;AAAA,EACL,CAAC;AACH;AAYA,eAAsB,gBAAgB;AAAA,EACpC,SAAS;AAAA,EACT;AAAA,EACA;AAAA,EACA,SAAAC;AAAA,EACA;AACF,GAMsB;AACpB,QAAM,EAAE,QAAQ,UAAU,SAAS,IAAI;AAGvC,MAAI,CAAC,UAAU,CAAC,UAAU;AACxB,eAAW,QAAQ,UAAU,UAAU;AAAA,MACrC,GAAG;AAAA,IACL,CAAC;AAGD,UAAM,IAAI,MAAM,iHAA4B;AAAA,EAC9C;AAKA,QAAM,MAAM,iBAAiB,EAAE,GAAG,YAAY,OAAO,CAAC;AACtD,aAAW,QAAQ,UAAU,KAAK,EAAE,GAAG,WAAW,CAAC;AAMnD,QAAM,gBAA6B;AAAA;AAAA,IAEjC,GAAGA;AAAA;AAAA,IAEH,iCAAiC,OAAO,CAAC,CAAC,MAAM;AAAA,IAChD,uBAAuB;AAAA,IACvB,qBAAqB;AAAA,EACvB;AAGA,QAAM,YAAY,GAAG,UAAU,EAAE,GAAG,YAAY,EAAE,GAAG,eAAe,WAAW,YAAY,CAAC;AAC5F,SAAO,OAAO,eAAe,EAAE,oBAAoB,UAAU,CAAC;AAQ9D,QAAM,iBAAiB,gBACnB,IAAI,QAAQ,aAAa,IACzB,MAAM,uBAAuB,aAAa;AAE9C,aAAW,QAAQ,UAAU,KAAK;AAAA,IAChC;AAAA,IACA;AAAA,IACA,gBAAgB,iBACZ,OAAO,YAAY,IAAI,QAAQ,cAAc,CAAC,IAC9C;AAAA,EACN,CAAC;AAGD,MAAI,CAAC,iBAAiB,CAAC,gBAAgB;AAErC,UAAM,IAAI,MAAM,qFAAoB;AAAA,EACtC;AAMA,QAAM,eAA0C;AAAA,IAC9C;AAAA,IACA,SAAS;AAAA,EACX;AAGA,MAAI,WAAW,SAAS,aAAa,QAAW;AAC9C,eAAW,QAAQ,UAAU,KAAK,EAAE,SAAS,CAAC;AAE9C,UAAM,gBAAgBD,6BAA4B,QAAQ,EAAE,SAAS;AACrE,eAAW,QAAQ,UAAU,KAAK,EAAE,cAAc,CAAC;AAEnD,QAAI,eAAe;AACjB,iBAAW,QAAQ,UAAU,KAAK,EAAE,SAAS,uCAAc,CAAC;AAC5D,aAAO,OAAO,cAAc;AAAA,QAC1B,MAAM,CAAC,UAAU,QAAQ,EAAE,SAAS,OAAO,QAAQ,IAC/C,OAAO,QAAQ,IACf,KAAK,UAAU,QAAQ;AAAA,MAC7B,CAAC;AAAA,IACH,OAAO;AACL,iBAAW,QAAQ,UAAU,KAAK,EAAE,SAAS,uCAAc,CAAC;AAAA,IAC9D;AAAA,EACF;AAKA,aAAW,QAAQ,UAAU,KAAK;AAAA,IAChC,cAAc;AAAA,MACZ,GAAG;AAAA,MACH,SAAS,iBACL,OAAO,YAAY,IAAI,QAAQ,cAAc,CAAC,IAC9C;AAAA,IACN;AAAA,EACF,CAAC;AACD,SAAO,MAAM,MAAM,KAAK,gBAAgB,YAAY,CAAC;AAEvD;AAqBA,eAAsB,wBAAsC;AAAA,EAC1D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAgCyC;AACvC,QAAM,uBACJ,OAAO,SAAS,eAAe,YAC/B,MAAM,KAAK,QAAQ,UAAU,EAAE,KAAK,UAAQ,KAAK,WAAW,CAAC,IAAI,GAAG;AAEtE,QAAM,WAAW,aAAa;AAAA,IAC5B;AAAA,IACA,uBAAuB,EAAE,GAAG,SAAS,YAAY,OAAU,IAAI;AAAA,EACjE;AAEA,WAAS,QAAQ,IAAI,iCAAiC,OAAO,CAAC,CAAC,MAAM,CAAC;AACtE,WAAS,QAAQ,IAAI,uBAAuB,MAAM;AAClD,WAAS,QAAQ,IAAI,qBAAqB,QAAQ;AAElD,QAAM,MACJ,WACA,GAAG,UAAU,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,gBAAgB,WAAW,cAAc,eAAe,YAAY,CAAC;AACjH,WAAS,QAAQ,IAAI,oBAAoB,GAAG;AAE5C,SAAO;AACT;","names":["headers","convertObjectToSearchParams","headers"]}
|
|
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"]}
|