@uniai-fe/util-next 0.1.0 → 0.1.2

package/README.md

@@ -1,22 +1,3 @@
 # util / next
 
 Next.js 전용 API 도우미 모음입니다.
-
-- `createNextApiClient`로 `@uniai-fe/util-functions`의 공용 API 유틸에 환경 설정을 주입합니다.
-- `setTokenRequestHeaders`, `setDebugResponseHeaders` 등 서버 라우트에서 반복되는 패턴을 제공합니다.
-- `api-infra.config.ts`처럼 프로젝트별 환경 구성을 받아 도메인을 해석하도록 설계되어 있습니다.
-
-## 사용 방법
-
-1. **환경 해석기 구성**
-   - 서비스 루트(예: `apps/factory/src/lib/server/api-infra.ts`)에서 `NextApiConfig`를 선언하고 `process.env`에 있는 API 베이스 URL을 `env` 맵으로 전달합니다.
-   - `createNextApiClient(config)`를 호출한 뒤 `generateBackendQueryUrl_GET`, `fetchBackendQuery`, `getQueryString` 등을 구조 분해하여 프로젝트 전역에서 재사용합니다.
-2. **로거 · 도메인 유틸 노출**
-   - `apiClient.logger`를 그대로 export하면 `nextAPILog`처럼 어느 라우트에서도 동일한 로깅 포맷을 유지할 수 있습니다.
-   - `resolveNextDomainSources(infra, config)`를 감싼 `resolveInfraDomain` 헬퍼를 만들어 두면 env 접근 없이도 도메인 문자열을 얻을 수 있습니다.
-3. **Next API 라우트에서 사용**
-   - `/app/api` 경로의 라우트에서 방금 만든 헬퍼를 import 하여 `generateBackendQueryUrl_GET`로 URL을 계산하고, 응답 시 `setDebugResponseHeaders`에 `infra`와 `queryUrl`을 넘겨 디버깅 헤더를 자동으로 채웁니다.
-   - POST/DELETE 요청이 필요한 경우에는 헬퍼에 정의한 `fetchWithBody`나 `fetchBackendQuery`를 호출해 동일한 로깅/대체 응답 로직을 공유하세요.
-4. **추가 서버 유틸 통합**
-   - `setTokenRequestHeaders`를 사용하면 Server Action·Route Handler에서 Authorization 헤더를 안전하게 추출할 수 있습니다.
-   - 필요 시 `resolveNextDomainSources` 반환값의 `hasEnv`, `envKey`를 활용해 런타임 환경 구성 상태를 점검하거나 헤더에 노출할 수 있습니다.

package/dist/index.cjs

@@ -1,43 +1,37 @@
 'use strict';
 
+var headers = require('next/headers');
+var server = require('next/server');
 var api = require('@uniai-fe/util-functions/api');
 
-// src/infra/index.ts
-var ENV_KEY_MAP = {
-  ai: "AI_API_BASE",
-  db: "DB_API_BASE",
-  uniai: "UNIAI_API_BASE"
-};
-var resolveNextDomainSources = (infra, config) => {
-  const envKey = ENV_KEY_MAP[infra];
-  const configValue = config?.env?.[infra];
-  const envValue = typeof envKey === "string" && envKey in process.env ? process.env[envKey] : void 0;
-  const domain = configValue ?? envValue ?? (typeof infra === "string" && infra.length > 0 ? infra : "");
-  return {
-    domain,
-    envKey,
-    envValue: envValue ?? void 0,
-    configValue,
-    hasEnv: Boolean(configValue ?? envValue)
-  };
-};
-var createNextDomainResolver = (config) => {
-  return (infra) => resolveNextDomainSources(infra, config).domain;
-};
-var createNextApiClient = (config, options) => {
-  const resolveDomain = createNextDomainResolver(config);
-  return api.createBackendApiClient({
-    resolveDomain,
-    logger: options?.logger ?? api.defaultApiLogger
+// src/server/module.ts
+async function setTokenRequestHeaders() {
+  const nextHeaders = await headers.headers();
+  const token = nextHeaders.get("Authorization") || "";
+  if (!token) return void 0;
+  return new Headers({
+    Authorization: token
   });
-};
+}
+async function setDebugResponseHeaders({
+  res,
+  domain,
+  queryUrl,
+  queryString,
+  searchParams,
+  fullUrl,
+  options
+}) {
+  const response = server.NextResponse.json(res, options);
+  response.headers.set("Uniai-Native-Domain-Env-Exist", String(!!domain));
+  response.headers.set("Uniai-Native-Domain", domain);
+  response.headers.set("Uniai-Native-Path", queryUrl);
+  const url = fullUrl || `${domain || ""}${queryUrl || ""}${queryString || searchParams ? api.getQueryString(searchParams) : ""}`;
+  response.headers.set("Uniai-Native-URL", url);
+  return response;
+}
 
-Object.defineProperty(exports, "defaultApiLogger", {
-  enumerable: true,
-  get: function () { return api.defaultApiLogger; }
-});
-exports.createNextApiClient = createNextApiClient;
-exports.createNextDomainResolver = createNextDomainResolver;
-exports.resolveNextDomainSources = resolveNextDomainSources;
+exports.setDebugResponseHeaders = setDebugResponseHeaders;
+exports.setTokenRequestHeaders = setTokenRequestHeaders;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/infra/index.ts"],"names":["createBackendApiClient","defaultApiLogger"],"mappings":";;;;;AAaA,IAAM,WAAA,GAAiD;AAAA,EACrD,EAAA,EAAI,aAAA;AAAA,EACJ,EAAA,EAAI,aAAA;AAAA,EACJ,KAAA,EAAO;AACT,CAAA;AAIO,IAAM,wBAAA,GAA2B,CACtC,KAAA,EACA,MAAA,KAC4B;AAC5B,EAAA,MAAM,MAAA,GAAS,YAAY,KAAK,CAAA;AAChC,EAAA,MAAM,WAAA,GAAc,MAAA,EAAQ,GAAA,GAAM,KAAK,CAAA;AACvC,EAAA,MAAM,QAAA,GACJ,OAAO,MAAA,KAAW,QAAA,IAAY,MAAA,IAAU,QAAQ,GAAA,GAC5C,OAAA,CAAQ,GAAA,CAAI,MAAM,CAAA,GAClB,MAAA;AAEN,EAAA,MAAM,MAAA,GACJ,eACA,QAAA,KACC,OAAO,UAAU,QAAA,IAAY,KAAA,CAAM,MAAA,GAAS,CAAA,GAAI,KAAA,GAAQ,EAAA,CAAA;AAE3D,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,MAAA;AAAA,IACA,UAAU,QAAA,IAAY,MAAA;AAAA,IACtB,WAAA;AAAA,IACA,MAAA,EAAQ,OAAA,CAAQ,WAAA,IAAe,QAAQ;AAAA,GACzC;AACF;AAEO,IAAM,wBAAA,GAA2B,CACtC,MAAA,KACmB;AACnB,EAAA,OAAO,CAAC,KAAA,KAAoB,wBAAA,CAAyB,KAAA,EAAO,MAAM,CAAA,CAAE,MAAA;AACtE;AAEO,IAAM,mBAAA,GAAsB,CACjC,MAAA,EACA,OAAA,KACG;AACH,EAAA,MAAM,aAAA,GAAgB,yBAAyB,MAAM,CAAA;AACrD,EAAA,OAAOA,0BAAA,CAAuB;AAAA,IAC5B,aAAA;AAAA,IACA,MAAA,EAAQ,SAAS,MAAA,IAAUC;AAAA,GAC5B,CAAA;AACH","file":"index.cjs","sourcesContent":["import {\n  createBackendApiClient,\n  defaultApiLogger,\n  type ApiLogger,\n  type DomainResolver,\n  type InfraKey,\n} from \"@uniai-fe/util-functions/api\";\nimport type {\n  NextApiConfig,\n  NextApiDomainMap,\n  ResolveNextDomainResult,\n} from \"./types\";\n\nconst ENV_KEY_MAP: Partial<Record<InfraKey, string>> = {\n  ai: \"AI_API_BASE\",\n  db: \"DB_API_BASE\",\n  uniai: \"UNIAI_API_BASE\",\n};\n\nexport type { NextApiConfig, NextApiDomainMap, ResolveNextDomainResult };\n\nexport const resolveNextDomainSources = (\n  infra: InfraKey,\n  config?: NextApiConfig,\n): ResolveNextDomainResult => {\n  const envKey = ENV_KEY_MAP[infra];\n  const configValue = config?.env?.[infra];\n  const envValue =\n    typeof envKey === \"string\" && envKey in process.env\n      ? process.env[envKey]\n      : undefined;\n\n  const domain =\n    configValue ??\n    envValue ??\n    (typeof infra === \"string\" && infra.length > 0 ? infra : \"\");\n\n  return {\n    domain,\n    envKey,\n    envValue: envValue ?? undefined,\n    configValue,\n    hasEnv: Boolean(configValue ?? envValue),\n  };\n};\n\nexport const createNextDomainResolver = (\n  config?: NextApiConfig,\n): DomainResolver => {\n  return (infra: InfraKey) => resolveNextDomainSources(infra, config).domain;\n};\n\nexport const createNextApiClient = (\n  config?: NextApiConfig,\n  options?: { logger?: ApiLogger },\n) => {\n  const resolveDomain = createNextDomainResolver(config);\n  return createBackendApiClient({\n    resolveDomain,\n    logger: options?.logger ?? defaultApiLogger,\n  });\n};\n"]}
+{"version":3,"sources":["../src/server/module.ts"],"names":["headers","NextResponse","getQueryString"],"mappings":";;;;;;;AAiBA,eAAsB,sBAAA,GAEpB;AACA,EAAA,MAAM,WAAA,GAAc,MAAMA,eAAA,EAAQ;AAClC,EAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,GAAA,CAAI,eAAe,CAAA,IAAK,EAAA;AAClD,EAAA,IAAI,CAAC,OAAO,OAAO,MAAA;AACnB,EAAA,OAAO,IAAI,OAAA,CAAQ;AAAA,IACjB,aAAA,EAAe;AAAA,GAChB,CAAA;AACH;AAqBA,eAAsB,uBAAA,CAAsC;AAAA,EAC1D,GAAA;AAAA,EACA,MAAA;AAAA,EACA,QAAA;AAAA,EACA,WAAA;AAAA,EACA,YAAA;AAAA,EACA,OAAA;AAAA,EACA;AACF,CAAA,EAgCyC;AACvC,EAAA,MAAM,QAAA,GAAWC,mBAAA,CAAa,IAAA,CAAK,GAAA,EAAK,OAAO,CAAA;AAE/C,EAAA,QAAA,CAAS,QAAQ,GAAA,CAAI,+BAAA,EAAiC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;AACtE,EAAA,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,qBAAA,EAAuB,MAAM,CAAA;AAClD,EAAA,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,mBAAA,EAAqB,QAAQ,CAAA;AAElD,EAAA,MAAM,GAAA,GACJ,OAAA,IACA,CAAA,EAAG,MAAA,IAAU,EAAE,CAAA,EAAG,QAAA,IAAY,EAAE,CAAA,EAAG,WAAA,IAAe,YAAA,GAAeC,kBAAA,CAAe,YAAY,IAAI,EAAE,CAAA,CAAA;AACpG,EAAA,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,kBAAA,EAAoB,GAAG,CAAA;AAE5C,EAAA,OAAO,QAAA;AACT","file":"index.cjs","sourcesContent":["\"use server\";\n\nimport { headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport { getQueryString } from \"@uniai-fe/util-functions/api\";\n\n/**\n * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n *\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n *\n * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n */\n\nexport async function setTokenRequestHeaders(): Promise<\n  HeadersInit | undefined\n> {\n  const nextHeaders = await headers();\n  const token = nextHeaders.get(\"Authorization\") || \"\";\n  if (!token) return undefined;\n  return new Headers({\n    Authorization: token,\n  });\n}\n\n/**\n * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n */\nexport async function setDebugResponseHeaders<ResponseData>({\n  res,\n  domain,\n  queryUrl,\n  queryString,\n  searchParams,\n  fullUrl,\n  options,\n}: {\n  /**\n   * fetch 응답 데이터\n   */\n  res: ResponseData;\n  /**\n   * API 도메인\n   * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n   * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n   */\n  domain: string;\n  /**\n   * API 엔드포인트 쿼리 path\n   */\n  queryUrl: string;\n} & Partial<{\n  /**\n   * 쿼리스트링\n   */\n  queryString: string;\n  /**\n   * URLSearchParams 객체\n   */\n  searchParams: URLSearchParams | object;\n  /**\n   * 전체 URL\n   */\n  fullUrl: string;\n  /**\n   * 응답 옵션\n   */\n  options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n  const response = NextResponse.json(res, options);\n\n  response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n  response.headers.set(\"Uniai-Native-Domain\", domain);\n  response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n  const url =\n    fullUrl ||\n    `${domain || \"\"}${queryUrl || \"\"}${queryString || searchParams ? getQueryString(searchParams) : \"\"}`;\n  response.headers.set(\"Uniai-Native-URL\", url);\n\n  return response;\n}\n"]}

package/dist/index.d.cts

@@ -1,2 +1,67 @@
-export { NextApiConfig, NextApiDomainMap, ResolveNextDomainResult, createNextApiClient, createNextDomainResolver, resolveNextDomainSources } from './infra/index.cjs';
-export { ApiLogger, CommonPostResponseType, InfraKey, defaultApiLogger } from '@uniai-fe/util-functions/api';
+import { NextResponse } from 'next/server';
+
+/**
+ * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.
+ *
+ * @remarks
+ * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.
+ * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.
+ * - Authorization 헤더가 없으면 undefined를 반환합니다.
+ *
+ * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined
+ */
+declare function setTokenRequestHeaders(): Promise<HeadersInit | undefined>;
+/**
+ * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정
+ * @util
+ * @desc
+ * 추가되는 헤더:
+ * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)
+ * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)
+ * - Uniai-Native-Path: 호출된 API path (queryUrl)
+ * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)
+ * @typeParam ResponseData - 응답 바디의 타입
+ * @property {ResponseData} res - fetch 응답 데이터
+ * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등
+ * @property {string} queryUrl - API 쿼리 URL
+ * @property {string} [queryString] - 쿼리 스트링
+ * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체
+ * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용
+ * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }
+ * @return {NextResponse<ResponseData>} 설정된 응답 객체
+ */
+declare function setDebugResponseHeaders<ResponseData>({ res, domain, queryUrl, queryString, searchParams, fullUrl, options, }: {
+    /**
+     * fetch 응답 데이터
+     */
+    res: ResponseData;
+    /**
+     * API 도메인
+     * - "ai"(ai-service), "db"(chickenmonger CRUD), "uniai"
+     * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용
+     */
+    domain: string;
+    /**
+     * API 엔드포인트 쿼리 path
+     */
+    queryUrl: string;
+} & Partial<{
+    /**
+     * 쿼리스트링
+     */
+    queryString: string;
+    /**
+     * URLSearchParams 객체
+     */
+    searchParams: URLSearchParams | object;
+    /**
+     * 전체 URL
+     */
+    fullUrl: string;
+    /**
+     * 응답 옵션
+     */
+    options: ResponseInit;
+}>): Promise<NextResponse<ResponseData>>;
+
+export { setDebugResponseHeaders, setTokenRequestHeaders };

package/dist/index.d.ts

@@ -1,2 +1,67 @@
-export { NextApiConfig, NextApiDomainMap, ResolveNextDomainResult, createNextApiClient, createNextDomainResolver, resolveNextDomainSources } from './infra/index.js';
-export { ApiLogger, CommonPostResponseType, InfraKey, defaultApiLogger } from '@uniai-fe/util-functions/api';
+import { NextResponse } from 'next/server';
+
+/**
+ * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.
+ *
+ * @remarks
+ * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.
+ * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.
+ * - Authorization 헤더가 없으면 undefined를 반환합니다.
+ *
+ * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined
+ */
+declare function setTokenRequestHeaders(): Promise<HeadersInit | undefined>;
+/**
+ * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정
+ * @util
+ * @desc
+ * 추가되는 헤더:
+ * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)
+ * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)
+ * - Uniai-Native-Path: 호출된 API path (queryUrl)
+ * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)
+ * @typeParam ResponseData - 응답 바디의 타입
+ * @property {ResponseData} res - fetch 응답 데이터
+ * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등
+ * @property {string} queryUrl - API 쿼리 URL
+ * @property {string} [queryString] - 쿼리 스트링
+ * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체
+ * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용
+ * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }
+ * @return {NextResponse<ResponseData>} 설정된 응답 객체
+ */
+declare function setDebugResponseHeaders<ResponseData>({ res, domain, queryUrl, queryString, searchParams, fullUrl, options, }: {
+    /**
+     * fetch 응답 데이터
+     */
+    res: ResponseData;
+    /**
+     * API 도메인
+     * - "ai"(ai-service), "db"(chickenmonger CRUD), "uniai"
+     * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용
+     */
+    domain: string;
+    /**
+     * API 엔드포인트 쿼리 path
+     */
+    queryUrl: string;
+} & Partial<{
+    /**
+     * 쿼리스트링
+     */
+    queryString: string;
+    /**
+     * URLSearchParams 객체
+     */
+    searchParams: URLSearchParams | object;
+    /**
+     * 전체 URL
+     */
+    fullUrl: string;
+    /**
+     * 응답 옵션
+     */
+    options: ResponseInit;
+}>): Promise<NextResponse<ResponseData>>;
+
+export { setDebugResponseHeaders, setTokenRequestHeaders };

package/dist/index.mjs

@@ -1,36 +1,34 @@
-import { createBackendApiClient, defaultApiLogger } from '@uniai-fe/util-functions/api';
-export { defaultApiLogger } from '@uniai-fe/util-functions/api';
+import { headers } from 'next/headers';
+import { NextResponse } from 'next/server';
+import { getQueryString } from '@uniai-fe/util-functions/api';
 
-// src/infra/index.ts
-var ENV_KEY_MAP = {
-  ai: "AI_API_BASE",
-  db: "DB_API_BASE",
-  uniai: "UNIAI_API_BASE"
-};
-var resolveNextDomainSources = (infra, config) => {
-  const envKey = ENV_KEY_MAP[infra];
-  const configValue = config?.env?.[infra];
-  const envValue = typeof envKey === "string" && envKey in process.env ? process.env[envKey] : void 0;
-  const domain = configValue ?? envValue ?? (typeof infra === "string" && infra.length > 0 ? infra : "");
-  return {
-    domain,
-    envKey,
-    envValue: envValue ?? void 0,
-    configValue,
-    hasEnv: Boolean(configValue ?? envValue)
-  };
-};
-var createNextDomainResolver = (config) => {
-  return (infra) => resolveNextDomainSources(infra, config).domain;
-};
-var createNextApiClient = (config, options) => {
-  const resolveDomain = createNextDomainResolver(config);
-  return createBackendApiClient({
-    resolveDomain,
-    logger: options?.logger ?? defaultApiLogger
+// src/server/module.ts
+async function setTokenRequestHeaders() {
+  const nextHeaders = await headers();
+  const token = nextHeaders.get("Authorization") || "";
+  if (!token) return void 0;
+  return new Headers({
+    Authorization: token
   });
-};
+}
+async function setDebugResponseHeaders({
+  res,
+  domain,
+  queryUrl,
+  queryString,
+  searchParams,
+  fullUrl,
+  options
+}) {
+  const response = NextResponse.json(res, options);
+  response.headers.set("Uniai-Native-Domain-Env-Exist", String(!!domain));
+  response.headers.set("Uniai-Native-Domain", domain);
+  response.headers.set("Uniai-Native-Path", queryUrl);
+  const url = fullUrl || `${domain || ""}${queryUrl || ""}${queryString || searchParams ? getQueryString(searchParams) : ""}`;
+  response.headers.set("Uniai-Native-URL", url);
+  return response;
+}
 
-export { createNextApiClient, createNextDomainResolver, resolveNextDomainSources };
+export { setDebugResponseHeaders, setTokenRequestHeaders };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/infra/index.ts"],"names":[],"mappings":";;;;AAaA,IAAM,WAAA,GAAiD;AAAA,EACrD,EAAA,EAAI,aAAA;AAAA,EACJ,EAAA,EAAI,aAAA;AAAA,EACJ,KAAA,EAAO;AACT,CAAA;AAIO,IAAM,wBAAA,GAA2B,CACtC,KAAA,EACA,MAAA,KAC4B;AAC5B,EAAA,MAAM,MAAA,GAAS,YAAY,KAAK,CAAA;AAChC,EAAA,MAAM,WAAA,GAAc,MAAA,EAAQ,GAAA,GAAM,KAAK,CAAA;AACvC,EAAA,MAAM,QAAA,GACJ,OAAO,MAAA,KAAW,QAAA,IAAY,MAAA,IAAU,QAAQ,GAAA,GAC5C,OAAA,CAAQ,GAAA,CAAI,MAAM,CAAA,GAClB,MAAA;AAEN,EAAA,MAAM,MAAA,GACJ,eACA,QAAA,KACC,OAAO,UAAU,QAAA,IAAY,KAAA,CAAM,MAAA,GAAS,CAAA,GAAI,KAAA,GAAQ,EAAA,CAAA;AAE3D,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,MAAA;AAAA,IACA,UAAU,QAAA,IAAY,MAAA;AAAA,IACtB,WAAA;AAAA,IACA,MAAA,EAAQ,OAAA,CAAQ,WAAA,IAAe,QAAQ;AAAA,GACzC;AACF;AAEO,IAAM,wBAAA,GAA2B,CACtC,MAAA,KACmB;AACnB,EAAA,OAAO,CAAC,KAAA,KAAoB,wBAAA,CAAyB,KAAA,EAAO,MAAM,CAAA,CAAE,MAAA;AACtE;AAEO,IAAM,mBAAA,GAAsB,CACjC,MAAA,EACA,OAAA,KACG;AACH,EAAA,MAAM,aAAA,GAAgB,yBAAyB,MAAM,CAAA;AACrD,EAAA,OAAO,sBAAA,CAAuB;AAAA,IAC5B,aAAA;AAAA,IACA,MAAA,EAAQ,SAAS,MAAA,IAAU;AAAA,GAC5B,CAAA;AACH","file":"index.mjs","sourcesContent":["import {\n  createBackendApiClient,\n  defaultApiLogger,\n  type ApiLogger,\n  type DomainResolver,\n  type InfraKey,\n} from \"@uniai-fe/util-functions/api\";\nimport type {\n  NextApiConfig,\n  NextApiDomainMap,\n  ResolveNextDomainResult,\n} from \"./types\";\n\nconst ENV_KEY_MAP: Partial<Record<InfraKey, string>> = {\n  ai: \"AI_API_BASE\",\n  db: \"DB_API_BASE\",\n  uniai: \"UNIAI_API_BASE\",\n};\n\nexport type { NextApiConfig, NextApiDomainMap, ResolveNextDomainResult };\n\nexport const resolveNextDomainSources = (\n  infra: InfraKey,\n  config?: NextApiConfig,\n): ResolveNextDomainResult => {\n  const envKey = ENV_KEY_MAP[infra];\n  const configValue = config?.env?.[infra];\n  const envValue =\n    typeof envKey === \"string\" && envKey in process.env\n      ? process.env[envKey]\n      : undefined;\n\n  const domain =\n    configValue ??\n    envValue ??\n    (typeof infra === \"string\" && infra.length > 0 ? infra : \"\");\n\n  return {\n    domain,\n    envKey,\n    envValue: envValue ?? undefined,\n    configValue,\n    hasEnv: Boolean(configValue ?? envValue),\n  };\n};\n\nexport const createNextDomainResolver = (\n  config?: NextApiConfig,\n): DomainResolver => {\n  return (infra: InfraKey) => resolveNextDomainSources(infra, config).domain;\n};\n\nexport const createNextApiClient = (\n  config?: NextApiConfig,\n  options?: { logger?: ApiLogger },\n) => {\n  const resolveDomain = createNextDomainResolver(config);\n  return createBackendApiClient({\n    resolveDomain,\n    logger: options?.logger ?? defaultApiLogger,\n  });\n};\n"]}
+{"version":3,"sources":["../src/server/module.ts"],"names":[],"mappings":";;;;;AAiBA,eAAsB,sBAAA,GAEpB;AACA,EAAA,MAAM,WAAA,GAAc,MAAM,OAAA,EAAQ;AAClC,EAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,GAAA,CAAI,eAAe,CAAA,IAAK,EAAA;AAClD,EAAA,IAAI,CAAC,OAAO,OAAO,MAAA;AACnB,EAAA,OAAO,IAAI,OAAA,CAAQ;AAAA,IACjB,aAAA,EAAe;AAAA,GAChB,CAAA;AACH;AAqBA,eAAsB,uBAAA,CAAsC;AAAA,EAC1D,GAAA;AAAA,EACA,MAAA;AAAA,EACA,QAAA;AAAA,EACA,WAAA;AAAA,EACA,YAAA;AAAA,EACA,OAAA;AAAA,EACA;AACF,CAAA,EAgCyC;AACvC,EAAA,MAAM,QAAA,GAAW,YAAA,CAAa,IAAA,CAAK,GAAA,EAAK,OAAO,CAAA;AAE/C,EAAA,QAAA,CAAS,QAAQ,GAAA,CAAI,+BAAA,EAAiC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;AACtE,EAAA,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,qBAAA,EAAuB,MAAM,CAAA;AAClD,EAAA,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,mBAAA,EAAqB,QAAQ,CAAA;AAElD,EAAA,MAAM,GAAA,GACJ,OAAA,IACA,CAAA,EAAG,MAAA,IAAU,EAAE,CAAA,EAAG,QAAA,IAAY,EAAE,CAAA,EAAG,WAAA,IAAe,YAAA,GAAe,cAAA,CAAe,YAAY,IAAI,EAAE,CAAA,CAAA;AACpG,EAAA,QAAA,CAAS,OAAA,CAAQ,GAAA,CAAI,kBAAA,EAAoB,GAAG,CAAA;AAE5C,EAAA,OAAO,QAAA;AACT","file":"index.mjs","sourcesContent":["\"use server\";\n\nimport { headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport { getQueryString } from \"@uniai-fe/util-functions/api\";\n\n/**\n * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.\n *\n * @remarks\n * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.\n * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.\n * - Authorization 헤더가 없으면 undefined를 반환합니다.\n *\n * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined\n */\n\nexport async function setTokenRequestHeaders(): Promise<\n  HeadersInit | undefined\n> {\n  const nextHeaders = await headers();\n  const token = nextHeaders.get(\"Authorization\") || \"\";\n  if (!token) return undefined;\n  return new Headers({\n    Authorization: token,\n  });\n}\n\n/**\n * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정\n * @util\n * @desc\n * 추가되는 헤더:\n * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)\n * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)\n * - Uniai-Native-Path: 호출된 API path (queryUrl)\n * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)\n * @typeParam ResponseData - 응답 바디의 타입\n * @property {ResponseData} res - fetch 응답 데이터\n * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등\n * @property {string} queryUrl - API 쿼리 URL\n * @property {string} [queryString] - 쿼리 스트링\n * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체\n * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용\n * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }\n * @return {NextResponse<ResponseData>} 설정된 응답 객체\n */\nexport async function setDebugResponseHeaders<ResponseData>({\n  res,\n  domain,\n  queryUrl,\n  queryString,\n  searchParams,\n  fullUrl,\n  options,\n}: {\n  /**\n   * fetch 응답 데이터\n   */\n  res: ResponseData;\n  /**\n   * API 도메인\n   * - \"ai\"(ai-service), \"db\"(chickenmonger CRUD), \"uniai\"\n   * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용\n   */\n  domain: string;\n  /**\n   * API 엔드포인트 쿼리 path\n   */\n  queryUrl: string;\n} & Partial<{\n  /**\n   * 쿼리스트링\n   */\n  queryString: string;\n  /**\n   * URLSearchParams 객체\n   */\n  searchParams: URLSearchParams | object;\n  /**\n   * 전체 URL\n   */\n  fullUrl: string;\n  /**\n   * 응답 옵션\n   */\n  options: ResponseInit;\n}>): Promise<NextResponse<ResponseData>> {\n  const response = NextResponse.json(res, options);\n\n  response.headers.set(\"Uniai-Native-Domain-Env-Exist\", String(!!domain));\n  response.headers.set(\"Uniai-Native-Domain\", domain);\n  response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n  const url =\n    fullUrl ||\n    `${domain || \"\"}${queryUrl || \"\"}${queryString || searchParams ? getQueryString(searchParams) : \"\"}`;\n  response.headers.set(\"Uniai-Native-URL\", url);\n\n  return response;\n}\n"]}

package/dist/server/index.cjs

@@ -1,13 +1,8 @@
 "use strict";
-"use server";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -16,54 +11,13 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var server_exports = {};
-__export(server_exports, {
-  setDebugResponseHeaders: () => setDebugResponseHeaders,
-  setTokenRequestHeaders: () => setTokenRequestHeaders
-});
 module.exports = __toCommonJS(server_exports);
-var import_headers = require("next/headers");
-var import_server = require("next/server");
-var import_api = require("@uniai-fe/util-functions/api");
-var import_infra = require("../infra");
-async function setTokenRequestHeaders() {
-  const nextHeaders = await (0, import_headers.headers)();
-  const token = nextHeaders.get("Authorization") || "";
-  if (!token) return void 0;
-  return new Headers({
-    Authorization: token
-  });
-}
-async function setDebugResponseHeaders(params) {
-  const {
-    res,
-    infra,
-    queryUrl,
-    config,
-    domain,
-    queryString,
-    searchParams,
-    fullUrl,
-    options
-  } = params;
-  const response = import_server.NextResponse.json(res, options);
-  const sources = (0, import_infra.resolveNextDomainSources)(infra, config);
-  const resolvedDomain = typeof domain === "string" && domain.length > 0 ? domain : sources.domain;
-  response.headers.set(
-    "Uniai-Native-Domain-Env-Exist",
-    String(sources.hasEnv)
-  );
-  response.headers.set("Uniai-Native-Domain", resolvedDomain || infra);
-  response.headers.set("Uniai-Native-Path", queryUrl);
-  const computedQuery = typeof queryString === "string" ? queryString : searchParams ? (0, import_api.getQueryString)(searchParams) : "";
-  const url = fullUrl || `${resolvedDomain || infra || ""}${queryUrl || ""}${computedQuery || ""}`;
-  response.headers.set("Uniai-Native-URL", url);
-  return response;
-}
+__reExport(server_exports, require("./module"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  setDebugResponseHeaders,
-  setTokenRequestHeaders
+  ...require("./module")
 });
 //# sourceMappingURL=index.cjs.map

package/dist/server/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/index.ts"],"sourcesContent":["\"use server\";\n\nimport { headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport { getQueryString, type InfraKey } from \"@uniai-fe/util-functions/api\";\nimport {\n  createNextDomainResolver,\n  resolveNextDomainSources,\n  type NextApiConfig,\n} from \"../infra\";\nimport type { SetDebugResponseHeadersParams } from \"./types\";\n\nexport async function setTokenRequestHeaders(): Promise<\n  HeadersInit | undefined\n> {\n  const nextHeaders = await headers();\n  const token = nextHeaders.get(\"Authorization\") || \"\";\n  if (!token) return undefined;\n  return new Headers({\n    Authorization: token,\n  });\n}\n\nexport type { SetDebugResponseHeadersParams };\n\nexport async function setDebugResponseHeaders<ResponseData>(\n  params: SetDebugResponseHeadersParams<InfraKey, ResponseData>,\n): Promise<NextResponse<ResponseData>> {\n  const {\n    res,\n    infra,\n    queryUrl,\n    config,\n    domain,\n    queryString,\n    searchParams,\n    fullUrl,\n    options,\n  } = params;\n\n  const response = NextResponse.json(res, options);\n  const sources = resolveNextDomainSources(infra, config);\n  const resolvedDomain =\n    typeof domain === \"string\" && domain.length > 0 ? domain : sources.domain;\n\n  response.headers.set(\n    \"Uniai-Native-Domain-Env-Exist\",\n    String(sources.hasEnv),\n  );\n  response.headers.set(\"Uniai-Native-Domain\", resolvedDomain || infra);\n  response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n  const computedQuery =\n    typeof queryString === \"string\"\n      ? queryString\n      : searchParams\n        ? getQueryString(searchParams)\n        : \"\";\n  const url =\n    fullUrl ||\n    `${resolvedDomain || infra || \"\"}${queryUrl || \"\"}${computedQuery || \"\"}`;\n  response.headers.set(\"Uniai-Native-URL\", url);\n\n  return response;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,qBAAwB;AACxB,oBAA6B;AAC7B,iBAA8C;AAC9C,mBAIO;AAGP,eAAsB,yBAEpB;AACA,QAAM,cAAc,UAAM,wBAAQ;AAClC,QAAM,QAAQ,YAAY,IAAI,eAAe,KAAK;AAClD,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,IAAI,QAAQ;AAAA,IACjB,eAAe;AAAA,EACjB,CAAC;AACH;AAIA,eAAsB,wBACpB,QACqC;AACrC,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AAEJ,QAAM,WAAW,2BAAa,KAAK,KAAK,OAAO;AAC/C,QAAM,cAAU,uCAAyB,OAAO,MAAM;AACtD,QAAM,iBACJ,OAAO,WAAW,YAAY,OAAO,SAAS,IAAI,SAAS,QAAQ;AAErE,WAAS,QAAQ;AAAA,IACf;AAAA,IACA,OAAO,QAAQ,MAAM;AAAA,EACvB;AACA,WAAS,QAAQ,IAAI,uBAAuB,kBAAkB,KAAK;AACnE,WAAS,QAAQ,IAAI,qBAAqB,QAAQ;AAElD,QAAM,gBACJ,OAAO,gBAAgB,WACnB,cACA,mBACE,2BAAe,YAAY,IAC3B;AACR,QAAM,MACJ,WACA,GAAG,kBAAkB,SAAS,EAAE,GAAG,YAAY,EAAE,GAAG,iBAAiB,EAAE;AACzE,WAAS,QAAQ,IAAI,oBAAoB,GAAG;AAE5C,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/server/index.ts"],"sourcesContent":["export * from \"./module\";\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAAA,2BAAc,qBAAd;","names":[]}

package/dist/server/index.d.cts

@@ -1,26 +1,67 @@
 import { NextResponse } from 'next/server';
-import { InfraKey } from '@uniai-fe/util-functions/api';
 
-type NextApiDomainMap = Partial<Record<InfraKey, string | undefined>>;
-type NextApiConfig = {
-    env?: NextApiDomainMap;
-};
-
-type SetDebugResponseHeadersParams<Infra extends InfraKey, ResponseData> = {
+/**
+ * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.
+ *
+ * @remarks
+ * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.
+ * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.
+ * - Authorization 헤더가 없으면 undefined를 반환합니다.
+ *
+ * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined
+ */
+declare function setTokenRequestHeaders(): Promise<HeadersInit | undefined>;
+/**
+ * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정
+ * @util
+ * @desc
+ * 추가되는 헤더:
+ * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)
+ * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)
+ * - Uniai-Native-Path: 호출된 API path (queryUrl)
+ * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)
+ * @typeParam ResponseData - 응답 바디의 타입
+ * @property {ResponseData} res - fetch 응답 데이터
+ * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등
+ * @property {string} queryUrl - API 쿼리 URL
+ * @property {string} [queryString] - 쿼리 스트링
+ * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체
+ * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용
+ * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }
+ * @return {NextResponse<ResponseData>} 설정된 응답 객체
+ */
+declare function setDebugResponseHeaders<ResponseData>({ res, domain, queryUrl, queryString, searchParams, fullUrl, options, }: {
+    /**
+     * fetch 응답 데이터
+     */
     res: ResponseData;
-    infra: Infra;
+    /**
+     * API 도메인
+     * - "ai"(ai-service), "db"(chickenmonger CRUD), "uniai"
+     * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용
+     */
+    domain: string;
+    /**
+     * API 엔드포인트 쿼리 path
+     */
     queryUrl: string;
 } & Partial<{
-    config: NextApiConfig;
-    domain: string;
+    /**
+     * 쿼리스트링
+     */
     queryString: string;
+    /**
+     * URLSearchParams 객체
+     */
     searchParams: URLSearchParams | object;
+    /**
+     * 전체 URL
+     */
     fullUrl: string;
+    /**
+     * 응답 옵션
+     */
     options: ResponseInit;
-}>;
-
-declare function setTokenRequestHeaders(): Promise<HeadersInit | undefined>;
-
-declare function setDebugResponseHeaders<ResponseData>(params: SetDebugResponseHeadersParams<InfraKey, ResponseData>): Promise<NextResponse<ResponseData>>;
+}>): Promise<NextResponse<ResponseData>>;
 
-export { type SetDebugResponseHeadersParams, setDebugResponseHeaders, setTokenRequestHeaders };
+export { setDebugResponseHeaders, setTokenRequestHeaders };

package/dist/server/index.d.ts

@@ -1,26 +1,67 @@
 import { NextResponse } from 'next/server';
-import { InfraKey } from '@uniai-fe/util-functions/api';
 
-type NextApiDomainMap = Partial<Record<InfraKey, string | undefined>>;
-type NextApiConfig = {
-    env?: NextApiDomainMap;
-};
-
-type SetDebugResponseHeadersParams<Infra extends InfraKey, ResponseData> = {
+/**
+ * 서버 환경의 현재 요청 헤더에서 Authorization 값을 읽어 fetch 요청에 사용할 Headers 객체로 반환합니다.
+ *
+ * @remarks
+ * - Next.js의 server environment(예: server actions, route handlers 등)에서 동작합니다.
+ * - 내부적으로 next/headers의 headers()를 호출하여 현재 요청 헤더를 조회합니다.
+ * - Authorization 헤더가 없으면 undefined를 반환합니다.
+ *
+ * @returns {Promise<HeadersInit | undefined>} Authorization 헤더가 설정된 Headers 객체 또는 Authorization 헤더가 없을 경우 undefined
+ */
+declare function setTokenRequestHeaders(): Promise<HeadersInit | undefined>;
+/**
+ * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정
+ * @util
+ * @desc
+ * 추가되는 헤더:
+ * - Uniai-Native-Domain-Env-Exist: 환경변수로 정의된 API 도메인 값 존재 여부 (boolean 문자열)
+ * - Uniai-Native-Domain: 사용된 API 도메인(환경변수 또는 infra 키)
+ * - Uniai-Native-Path: 호출된 API path (queryUrl)
+ * - Uniai-Native-URL: 최종 생성된 전체 URL (fullUrl이 주어지면 그 값을 사용, 그렇지 않으면 infra 도메인 + path + 쿼리스트링)
+ * @typeParam ResponseData - 응답 바디의 타입
+ * @property {ResponseData} res - fetch 응답 데이터
+ * @property {string} infra - API 도메인 키; ai(ai-service), db(chickenmonger CRUD), uniai 등
+ * @property {string} queryUrl - API 쿼리 URL
+ * @property {string} [queryString] - 쿼리 스트링
+ * @property {URLSearchParams | object} [searchParams] - 쿼리 파라미터 객체
+ * @property {string} [fullUrl] - 전체 url이 제공되면, Uniai-Native-URL 헤더에 우선적으로 적용
+ * @property {ResponseInit} [options] - fetch native 옵션 { headers, body, ... }
+ * @return {NextResponse<ResponseData>} 설정된 응답 객체
+ */
+declare function setDebugResponseHeaders<ResponseData>({ res, domain, queryUrl, queryString, searchParams, fullUrl, options, }: {
+    /**
+     * fetch 응답 데이터
+     */
     res: ResponseData;
-    infra: Infra;
+    /**
+     * API 도메인
+     * - "ai"(ai-service), "db"(chickenmonger CRUD), "uniai"
+     * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용
+     */
+    domain: string;
+    /**
+     * API 엔드포인트 쿼리 path
+     */
     queryUrl: string;
 } & Partial<{
-    config: NextApiConfig;
-    domain: string;
+    /**
+     * 쿼리스트링
+     */
     queryString: string;
+    /**
+     * URLSearchParams 객체
+     */
     searchParams: URLSearchParams | object;
+    /**
+     * 전체 URL
+     */
     fullUrl: string;
+    /**
+     * 응답 옵션
+     */
     options: ResponseInit;
-}>;
-
-declare function setTokenRequestHeaders(): Promise<HeadersInit | undefined>;
-
-declare function setDebugResponseHeaders<ResponseData>(params: SetDebugResponseHeadersParams<InfraKey, ResponseData>): Promise<NextResponse<ResponseData>>;
+}>): Promise<NextResponse<ResponseData>>;
 
-export { type SetDebugResponseHeadersParams, setDebugResponseHeaders, setTokenRequestHeaders };
+export { setDebugResponseHeaders, setTokenRequestHeaders };

package/dist/server/index.mjs

@@ -1,46 +1,2 @@
-"use server";
-import { headers } from "next/headers";
-import { NextResponse } from "next/server";
-import { getQueryString } from "@uniai-fe/util-functions/api";
-import {
-  resolveNextDomainSources
-} from "../infra";
-async function setTokenRequestHeaders() {
-  const nextHeaders = await headers();
-  const token = nextHeaders.get("Authorization") || "";
-  if (!token) return void 0;
-  return new Headers({
-    Authorization: token
-  });
-}
-async function setDebugResponseHeaders(params) {
-  const {
-    res,
-    infra,
-    queryUrl,
-    config,
-    domain,
-    queryString,
-    searchParams,
-    fullUrl,
-    options
-  } = params;
-  const response = NextResponse.json(res, options);
-  const sources = resolveNextDomainSources(infra, config);
-  const resolvedDomain = typeof domain === "string" && domain.length > 0 ? domain : sources.domain;
-  response.headers.set(
-    "Uniai-Native-Domain-Env-Exist",
-    String(sources.hasEnv)
-  );
-  response.headers.set("Uniai-Native-Domain", resolvedDomain || infra);
-  response.headers.set("Uniai-Native-Path", queryUrl);
-  const computedQuery = typeof queryString === "string" ? queryString : searchParams ? getQueryString(searchParams) : "";
-  const url = fullUrl || `${resolvedDomain || infra || ""}${queryUrl || ""}${computedQuery || ""}`;
-  response.headers.set("Uniai-Native-URL", url);
-  return response;
-}
-export {
-  setDebugResponseHeaders,
-  setTokenRequestHeaders
-};
+export * from "./module";
 //# sourceMappingURL=index.mjs.map

package/dist/server/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/index.ts"],"sourcesContent":["\"use server\";\n\nimport { headers } from \"next/headers\";\nimport { NextResponse } from \"next/server\";\nimport { getQueryString, type InfraKey } from \"@uniai-fe/util-functions/api\";\nimport {\n  createNextDomainResolver,\n  resolveNextDomainSources,\n  type NextApiConfig,\n} from \"../infra\";\nimport type { SetDebugResponseHeadersParams } from \"./types\";\n\nexport async function setTokenRequestHeaders(): Promise<\n  HeadersInit | undefined\n> {\n  const nextHeaders = await headers();\n  const token = nextHeaders.get(\"Authorization\") || \"\";\n  if (!token) return undefined;\n  return new Headers({\n    Authorization: token,\n  });\n}\n\nexport type { SetDebugResponseHeadersParams };\n\nexport async function setDebugResponseHeaders<ResponseData>(\n  params: SetDebugResponseHeadersParams<InfraKey, ResponseData>,\n): Promise<NextResponse<ResponseData>> {\n  const {\n    res,\n    infra,\n    queryUrl,\n    config,\n    domain,\n    queryString,\n    searchParams,\n    fullUrl,\n    options,\n  } = params;\n\n  const response = NextResponse.json(res, options);\n  const sources = resolveNextDomainSources(infra, config);\n  const resolvedDomain =\n    typeof domain === \"string\" && domain.length > 0 ? domain : sources.domain;\n\n  response.headers.set(\n    \"Uniai-Native-Domain-Env-Exist\",\n    String(sources.hasEnv),\n  );\n  response.headers.set(\"Uniai-Native-Domain\", resolvedDomain || infra);\n  response.headers.set(\"Uniai-Native-Path\", queryUrl);\n\n  const computedQuery =\n    typeof queryString === \"string\"\n      ? queryString\n      : searchParams\n        ? getQueryString(searchParams)\n        : \"\";\n  const url =\n    fullUrl ||\n    `${resolvedDomain || infra || \"\"}${queryUrl || \"\"}${computedQuery || \"\"}`;\n  response.headers.set(\"Uniai-Native-URL\", url);\n\n  return response;\n}\n"],"mappings":";AAEA,SAAS,eAAe;AACxB,SAAS,oBAAoB;AAC7B,SAAS,sBAAqC;AAC9C;AAAA,EAEE;AAAA,OAEK;AAGP,eAAsB,yBAEpB;AACA,QAAM,cAAc,MAAM,QAAQ;AAClC,QAAM,QAAQ,YAAY,IAAI,eAAe,KAAK;AAClD,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,IAAI,QAAQ;AAAA,IACjB,eAAe;AAAA,EACjB,CAAC;AACH;AAIA,eAAsB,wBACpB,QACqC;AACrC,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AAEJ,QAAM,WAAW,aAAa,KAAK,KAAK,OAAO;AAC/C,QAAM,UAAU,yBAAyB,OAAO,MAAM;AACtD,QAAM,iBACJ,OAAO,WAAW,YAAY,OAAO,SAAS,IAAI,SAAS,QAAQ;AAErE,WAAS,QAAQ;AAAA,IACf;AAAA,IACA,OAAO,QAAQ,MAAM;AAAA,EACvB;AACA,WAAS,QAAQ,IAAI,uBAAuB,kBAAkB,KAAK;AACnE,WAAS,QAAQ,IAAI,qBAAqB,QAAQ;AAElD,QAAM,gBACJ,OAAO,gBAAgB,WACnB,cACA,eACE,eAAe,YAAY,IAC3B;AACR,QAAM,MACJ,WACA,GAAG,kBAAkB,SAAS,EAAE,GAAG,YAAY,EAAE,GAAG,iBAAiB,EAAE;AACzE,WAAS,QAAQ,IAAI,oBAAoB,GAAG;AAE5C,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/server/index.ts"],"sourcesContent":["export * from \"./module\";\n"],"mappings":"AAAA,cAAc;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniai-fe/util-next",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Next.js Utilities for UNIAI FE Projects",
   "type": "module",
   "private": false,
@@ -10,7 +10,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "packageManager": "pnpm@10.20.0",
+  "packageManager": "pnpm@10.22.0",
   "engines": {
     "node": ">=22",
     "pnpm": ">=10"
@@ -24,8 +24,13 @@
     "dist"
   ],
   "scripts": {
+    "lint": "eslint . --max-warnings=0",
+    "typecheck": "tsc --project tsconfig.build.json --noEmit",
     "build": "tsup",
-    "dev": "tsup --watch",
+    "dev": "node ../../../scripts/tsup-watch-filter.mjs --watch",
+    "module:lint": "pnpm lint",
+    "module:typecheck": "pnpm typecheck",
+    "module:build": "pnpm build",
     "util-next:build": "pnpm run build",
     "util-next:dev": "pnpm run dev"
   },
@@ -40,25 +45,25 @@
       "default": "./dist/index.mjs"
     },
     "./server": {
-      "types": "./dist/server.d.ts",
-      "import": "./dist/server.mjs",
-      "require": "./dist/server.cjs",
-      "default": "./dist/server.mjs"
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.mjs",
+      "require": "./dist/server/index.cjs",
+      "default": "./dist/server/index.mjs"
     }
   },
   "dependencies": {
-    "@uniai-fe/util-functions": "workspace:*"
+    "@uniai-fe/util-functions": "^0.1.1"
   },
   "peerDependencies": {
     "next": ">= 15"
   },
   "devDependencies": {
-    "@types/node": "^22.15.30",
+    "@types/node": "^24.10.1",
     "@uniai-fe/eslint-config": "workspace:*",
     "@uniai-fe/tsconfig": "workspace:*",
-    "eslint": "^9.38.0",
+    "eslint": "^9.39.1",
     "prettier": "^3.6.2",
-    "tsup": "^8.5.0",
+    "tsup": "^8.5.1",
     "typescript": "~5.9.3"
   }
 }

package/dist/infra/index.cjs

@@ -1,39 +0,0 @@
-'use strict';
-
-var api = require('@uniai-fe/util-functions/api');
-
-// src/infra/index.ts
-var ENV_KEY_MAP = {
-  ai: "AI_API_BASE",
-  db: "DB_API_BASE",
-  uniai: "UNIAI_API_BASE"
-};
-var resolveNextDomainSources = (infra, config) => {
-  const envKey = ENV_KEY_MAP[infra];
-  const configValue = config?.env?.[infra];
-  const envValue = typeof envKey === "string" && envKey in process.env ? process.env[envKey] : void 0;
-  const domain = configValue ?? envValue ?? (typeof infra === "string" && infra.length > 0 ? infra : "");
-  return {
-    domain,
-    envKey,
-    envValue: envValue ?? void 0,
-    configValue,
-    hasEnv: Boolean(configValue ?? envValue)
-  };
-};
-var createNextDomainResolver = (config) => {
-  return (infra) => resolveNextDomainSources(infra, config).domain;
-};
-var createNextApiClient = (config, options) => {
-  const resolveDomain = createNextDomainResolver(config);
-  return api.createBackendApiClient({
-    resolveDomain,
-    logger: options?.logger ?? api.defaultApiLogger
-  });
-};
-
-exports.createNextApiClient = createNextApiClient;
-exports.createNextDomainResolver = createNextDomainResolver;
-exports.resolveNextDomainSources = resolveNextDomainSources;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map

package/dist/infra/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/infra/index.ts"],"names":["createBackendApiClient","defaultApiLogger"],"mappings":";;;;;AAaA,IAAM,WAAA,GAAiD;AAAA,EACrD,EAAA,EAAI,aAAA;AAAA,EACJ,EAAA,EAAI,aAAA;AAAA,EACJ,KAAA,EAAO;AACT,CAAA;AAIO,IAAM,wBAAA,GAA2B,CACtC,KAAA,EACA,MAAA,KAC4B;AAC5B,EAAA,MAAM,MAAA,GAAS,YAAY,KAAK,CAAA;AAChC,EAAA,MAAM,WAAA,GAAc,MAAA,EAAQ,GAAA,GAAM,KAAK,CAAA;AACvC,EAAA,MAAM,QAAA,GACJ,OAAO,MAAA,KAAW,QAAA,IAAY,MAAA,IAAU,QAAQ,GAAA,GAC5C,OAAA,CAAQ,GAAA,CAAI,MAAM,CAAA,GAClB,MAAA;AAEN,EAAA,MAAM,MAAA,GACJ,eACA,QAAA,KACC,OAAO,UAAU,QAAA,IAAY,KAAA,CAAM,MAAA,GAAS,CAAA,GAAI,KAAA,GAAQ,EAAA,CAAA;AAE3D,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,MAAA;AAAA,IACA,UAAU,QAAA,IAAY,MAAA;AAAA,IACtB,WAAA;AAAA,IACA,MAAA,EAAQ,OAAA,CAAQ,WAAA,IAAe,QAAQ;AAAA,GACzC;AACF;AAEO,IAAM,wBAAA,GAA2B,CACtC,MAAA,KACmB;AACnB,EAAA,OAAO,CAAC,KAAA,KAAoB,wBAAA,CAAyB,KAAA,EAAO,MAAM,CAAA,CAAE,MAAA;AACtE;AAEO,IAAM,mBAAA,GAAsB,CACjC,MAAA,EACA,OAAA,KACG;AACH,EAAA,MAAM,aAAA,GAAgB,yBAAyB,MAAM,CAAA;AACrD,EAAA,OAAOA,0BAAA,CAAuB;AAAA,IAC5B,aAAA;AAAA,IACA,MAAA,EAAQ,SAAS,MAAA,IAAUC;AAAA,GAC5B,CAAA;AACH","file":"index.cjs","sourcesContent":["import {\n  createBackendApiClient,\n  defaultApiLogger,\n  type ApiLogger,\n  type DomainResolver,\n  type InfraKey,\n} from \"@uniai-fe/util-functions/api\";\nimport type {\n  NextApiConfig,\n  NextApiDomainMap,\n  ResolveNextDomainResult,\n} from \"./types\";\n\nconst ENV_KEY_MAP: Partial<Record<InfraKey, string>> = {\n  ai: \"AI_API_BASE\",\n  db: \"DB_API_BASE\",\n  uniai: \"UNIAI_API_BASE\",\n};\n\nexport type { NextApiConfig, NextApiDomainMap, ResolveNextDomainResult };\n\nexport const resolveNextDomainSources = (\n  infra: InfraKey,\n  config?: NextApiConfig,\n): ResolveNextDomainResult => {\n  const envKey = ENV_KEY_MAP[infra];\n  const configValue = config?.env?.[infra];\n  const envValue =\n    typeof envKey === \"string\" && envKey in process.env\n      ? process.env[envKey]\n      : undefined;\n\n  const domain =\n    configValue ??\n    envValue ??\n    (typeof infra === \"string\" && infra.length > 0 ? infra : \"\");\n\n  return {\n    domain,\n    envKey,\n    envValue: envValue ?? undefined,\n    configValue,\n    hasEnv: Boolean(configValue ?? envValue),\n  };\n};\n\nexport const createNextDomainResolver = (\n  config?: NextApiConfig,\n): DomainResolver => {\n  return (infra: InfraKey) => resolveNextDomainSources(infra, config).domain;\n};\n\nexport const createNextApiClient = (\n  config?: NextApiConfig,\n  options?: { logger?: ApiLogger },\n) => {\n  const resolveDomain = createNextDomainResolver(config);\n  return createBackendApiClient({\n    resolveDomain,\n    logger: options?.logger ?? defaultApiLogger,\n  });\n};\n"]}

package/dist/infra/index.d.cts

@@ -1,27 +0,0 @@
-import * as _uniai_fe_util_functions_api from '@uniai-fe/util-functions/api';
-import { InfraKey, DomainResolver, ApiLogger } from '@uniai-fe/util-functions/api';
-
-type NextApiDomainMap = Partial<Record<InfraKey, string | undefined>>;
-type NextApiConfig = {
-    env?: NextApiDomainMap;
-};
-type ResolveNextDomainResult = {
-    domain: string;
-    envKey?: string;
-    envValue?: string;
-    configValue?: string;
-    hasEnv: boolean;
-};
-
-declare const resolveNextDomainSources: (infra: InfraKey, config?: NextApiConfig) => ResolveNextDomainResult;
-declare const createNextDomainResolver: (config?: NextApiConfig) => DomainResolver;
-declare const createNextApiClient: (config?: NextApiConfig, options?: {
-    logger?: ApiLogger;
-}) => {
-    getQueryString: (searchParams?: unknown) => string;
-    generateBackendQueryUrl_GET: ({ infra, domain, routeUrl, queryUrl, searchParams, log, logDisabled, logger, }: _uniai_fe_util_functions_api.GenerateBackendQueryUrlOptions<InfraKey>) => string;
-    fetchBackendQuery: <FetchRequestType extends object, FetchResponseType extends _uniai_fe_util_functions_api.CommonPostResponseType>({ infra, domain, routeUrl, queryUrl, method, headers, body, bodyOriginData, queryStringData, log, logDisabled, fetchDisabled, logger, }: _uniai_fe_util_functions_api.FetchBackendQueryOptions<InfraKey, FetchRequestType>) => Promise<FetchResponseType>;
-    logger: ApiLogger;
-};
-
-export { type NextApiConfig, type NextApiDomainMap, type ResolveNextDomainResult, createNextApiClient, createNextDomainResolver, resolveNextDomainSources };

package/dist/infra/index.d.ts

@@ -1,27 +0,0 @@
-import * as _uniai_fe_util_functions_api from '@uniai-fe/util-functions/api';
-import { InfraKey, DomainResolver, ApiLogger } from '@uniai-fe/util-functions/api';
-
-type NextApiDomainMap = Partial<Record<InfraKey, string | undefined>>;
-type NextApiConfig = {
-    env?: NextApiDomainMap;
-};
-type ResolveNextDomainResult = {
-    domain: string;
-    envKey?: string;
-    envValue?: string;
-    configValue?: string;
-    hasEnv: boolean;
-};
-
-declare const resolveNextDomainSources: (infra: InfraKey, config?: NextApiConfig) => ResolveNextDomainResult;
-declare const createNextDomainResolver: (config?: NextApiConfig) => DomainResolver;
-declare const createNextApiClient: (config?: NextApiConfig, options?: {
-    logger?: ApiLogger;
-}) => {
-    getQueryString: (searchParams?: unknown) => string;
-    generateBackendQueryUrl_GET: ({ infra, domain, routeUrl, queryUrl, searchParams, log, logDisabled, logger, }: _uniai_fe_util_functions_api.GenerateBackendQueryUrlOptions<InfraKey>) => string;
-    fetchBackendQuery: <FetchRequestType extends object, FetchResponseType extends _uniai_fe_util_functions_api.CommonPostResponseType>({ infra, domain, routeUrl, queryUrl, method, headers, body, bodyOriginData, queryStringData, log, logDisabled, fetchDisabled, logger, }: _uniai_fe_util_functions_api.FetchBackendQueryOptions<InfraKey, FetchRequestType>) => Promise<FetchResponseType>;
-    logger: ApiLogger;
-};
-
-export { type NextApiConfig, type NextApiDomainMap, type ResolveNextDomainResult, createNextApiClient, createNextDomainResolver, resolveNextDomainSources };

package/dist/infra/index.mjs

@@ -1,35 +0,0 @@
-import { createBackendApiClient, defaultApiLogger } from '@uniai-fe/util-functions/api';
-
-// src/infra/index.ts
-var ENV_KEY_MAP = {
-  ai: "AI_API_BASE",
-  db: "DB_API_BASE",
-  uniai: "UNIAI_API_BASE"
-};
-var resolveNextDomainSources = (infra, config) => {
-  const envKey = ENV_KEY_MAP[infra];
-  const configValue = config?.env?.[infra];
-  const envValue = typeof envKey === "string" && envKey in process.env ? process.env[envKey] : void 0;
-  const domain = configValue ?? envValue ?? (typeof infra === "string" && infra.length > 0 ? infra : "");
-  return {
-    domain,
-    envKey,
-    envValue: envValue ?? void 0,
-    configValue,
-    hasEnv: Boolean(configValue ?? envValue)
-  };
-};
-var createNextDomainResolver = (config) => {
-  return (infra) => resolveNextDomainSources(infra, config).domain;
-};
-var createNextApiClient = (config, options) => {
-  const resolveDomain = createNextDomainResolver(config);
-  return createBackendApiClient({
-    resolveDomain,
-    logger: options?.logger ?? defaultApiLogger
-  });
-};
-
-export { createNextApiClient, createNextDomainResolver, resolveNextDomainSources };
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map

package/dist/infra/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/infra/index.ts"],"names":[],"mappings":";;;AAaA,IAAM,WAAA,GAAiD;AAAA,EACrD,EAAA,EAAI,aAAA;AAAA,EACJ,EAAA,EAAI,aAAA;AAAA,EACJ,KAAA,EAAO;AACT,CAAA;AAIO,IAAM,wBAAA,GAA2B,CACtC,KAAA,EACA,MAAA,KAC4B;AAC5B,EAAA,MAAM,MAAA,GAAS,YAAY,KAAK,CAAA;AAChC,EAAA,MAAM,WAAA,GAAc,MAAA,EAAQ,GAAA,GAAM,KAAK,CAAA;AACvC,EAAA,MAAM,QAAA,GACJ,OAAO,MAAA,KAAW,QAAA,IAAY,MAAA,IAAU,QAAQ,GAAA,GAC5C,OAAA,CAAQ,GAAA,CAAI,MAAM,CAAA,GAClB,MAAA;AAEN,EAAA,MAAM,MAAA,GACJ,eACA,QAAA,KACC,OAAO,UAAU,QAAA,IAAY,KAAA,CAAM,MAAA,GAAS,CAAA,GAAI,KAAA,GAAQ,EAAA,CAAA;AAE3D,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,MAAA;AAAA,IACA,UAAU,QAAA,IAAY,MAAA;AAAA,IACtB,WAAA;AAAA,IACA,MAAA,EAAQ,OAAA,CAAQ,WAAA,IAAe,QAAQ;AAAA,GACzC;AACF;AAEO,IAAM,wBAAA,GAA2B,CACtC,MAAA,KACmB;AACnB,EAAA,OAAO,CAAC,KAAA,KAAoB,wBAAA,CAAyB,KAAA,EAAO,MAAM,CAAA,CAAE,MAAA;AACtE;AAEO,IAAM,mBAAA,GAAsB,CACjC,MAAA,EACA,OAAA,KACG;AACH,EAAA,MAAM,aAAA,GAAgB,yBAAyB,MAAM,CAAA;AACrD,EAAA,OAAO,sBAAA,CAAuB;AAAA,IAC5B,aAAA;AAAA,IACA,MAAA,EAAQ,SAAS,MAAA,IAAU;AAAA,GAC5B,CAAA;AACH","file":"index.mjs","sourcesContent":["import {\n  createBackendApiClient,\n  defaultApiLogger,\n  type ApiLogger,\n  type DomainResolver,\n  type InfraKey,\n} from \"@uniai-fe/util-functions/api\";\nimport type {\n  NextApiConfig,\n  NextApiDomainMap,\n  ResolveNextDomainResult,\n} from \"./types\";\n\nconst ENV_KEY_MAP: Partial<Record<InfraKey, string>> = {\n  ai: \"AI_API_BASE\",\n  db: \"DB_API_BASE\",\n  uniai: \"UNIAI_API_BASE\",\n};\n\nexport type { NextApiConfig, NextApiDomainMap, ResolveNextDomainResult };\n\nexport const resolveNextDomainSources = (\n  infra: InfraKey,\n  config?: NextApiConfig,\n): ResolveNextDomainResult => {\n  const envKey = ENV_KEY_MAP[infra];\n  const configValue = config?.env?.[infra];\n  const envValue =\n    typeof envKey === \"string\" && envKey in process.env\n      ? process.env[envKey]\n      : undefined;\n\n  const domain =\n    configValue ??\n    envValue ??\n    (typeof infra === \"string\" && infra.length > 0 ? infra : \"\");\n\n  return {\n    domain,\n    envKey,\n    envValue: envValue ?? undefined,\n    configValue,\n    hasEnv: Boolean(configValue ?? envValue),\n  };\n};\n\nexport const createNextDomainResolver = (\n  config?: NextApiConfig,\n): DomainResolver => {\n  return (infra: InfraKey) => resolveNextDomainSources(infra, config).domain;\n};\n\nexport const createNextApiClient = (\n  config?: NextApiConfig,\n  options?: { logger?: ApiLogger },\n) => {\n  const resolveDomain = createNextDomainResolver(config);\n  return createBackendApiClient({\n    resolveDomain,\n    logger: options?.logger ?? defaultApiLogger,\n  });\n};\n"]}