@uniai-fe/util-next 0.1.0

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2025 UNIAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+This project includes third-party software governed by additional licenses,
+including Apache License 2.0. Refer to `THIRD_PARTY_NOTICES.md` for the full
+text of those notices and any required attributions.

package/README.md

@@ -0,0 +1,22 @@
+# 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

@@ -0,0 +1,43 @@
+'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
+  });
+};
+
+Object.defineProperty(exports, "defaultApiLogger", {
+  enumerable: true,
+  get: function () { return api.defaultApiLogger; }
+});
+exports.createNextApiClient = createNextApiClient;
+exports.createNextDomainResolver = createNextDomainResolver;
+exports.resolveNextDomainSources = resolveNextDomainSources;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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"]}

package/dist/index.d.cts

@@ -0,0 +1,2 @@
+export { NextApiConfig, NextApiDomainMap, ResolveNextDomainResult, createNextApiClient, createNextDomainResolver, resolveNextDomainSources } from './infra/index.cjs';
+export { ApiLogger, CommonPostResponseType, InfraKey, defaultApiLogger } from '@uniai-fe/util-functions/api';

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { NextApiConfig, NextApiDomainMap, ResolveNextDomainResult, createNextApiClient, createNextDomainResolver, resolveNextDomainSources } from './infra/index.js';
+export { ApiLogger, CommonPostResponseType, InfraKey, defaultApiLogger } from '@uniai-fe/util-functions/api';

package/dist/index.mjs

@@ -0,0 +1,36 @@
+import { createBackendApiClient, defaultApiLogger } from '@uniai-fe/util-functions/api';
+export { 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/index.mjs.map

@@ -0,0 +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"]}

package/dist/infra/index.cjs

@@ -0,0 +1,39 @@
+'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

@@ -0,0 +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"]}

package/dist/infra/index.d.cts

@@ -0,0 +1,27 @@
+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

@@ -0,0 +1,27 @@
+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

@@ -0,0 +1,35 @@
+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

@@ -0,0 +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"]}

package/dist/server/index.cjs

@@ -0,0 +1,69 @@
+"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))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+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;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  setDebugResponseHeaders,
+  setTokenRequestHeaders
+});
+//# sourceMappingURL=index.cjs.map

package/dist/server/index.cjs.map

@@ -0,0 +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":[]}

package/dist/server/index.d.cts

@@ -0,0 +1,26 @@
+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> = {
+    res: ResponseData;
+    infra: Infra;
+    queryUrl: string;
+} & Partial<{
+    config: NextApiConfig;
+    domain: string;
+    queryString: string;
+    searchParams: URLSearchParams | object;
+    fullUrl: string;
+    options: ResponseInit;
+}>;
+
+declare function setTokenRequestHeaders(): Promise<HeadersInit | undefined>;
+
+declare function setDebugResponseHeaders<ResponseData>(params: SetDebugResponseHeadersParams<InfraKey, ResponseData>): Promise<NextResponse<ResponseData>>;
+
+export { type SetDebugResponseHeadersParams, setDebugResponseHeaders, setTokenRequestHeaders };

package/dist/server/index.d.ts

@@ -0,0 +1,26 @@
+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> = {
+    res: ResponseData;
+    infra: Infra;
+    queryUrl: string;
+} & Partial<{
+    config: NextApiConfig;
+    domain: string;
+    queryString: string;
+    searchParams: URLSearchParams | object;
+    fullUrl: string;
+    options: ResponseInit;
+}>;
+
+declare function setTokenRequestHeaders(): Promise<HeadersInit | undefined>;
+
+declare function setDebugResponseHeaders<ResponseData>(params: SetDebugResponseHeadersParams<InfraKey, ResponseData>): Promise<NextResponse<ResponseData>>;
+
+export { type SetDebugResponseHeadersParams, setDebugResponseHeaders, setTokenRequestHeaders };

package/dist/server/index.mjs

@@ -0,0 +1,46 @@
+"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
+};
+//# sourceMappingURL=index.mjs.map

package/dist/server/index.mjs.map

@@ -0,0 +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":[]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@uniai-fe/util-next",
+  "version": "0.1.0",
+  "description": "Next.js Utilities for UNIAI FE Projects",
+  "type": "module",
+  "private": false,
+  "sideEffects": false,
+  "license": "MIT",
+  "homepage": "https://www.uniai.co.kr/",
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@10.20.0",
+  "engines": {
+    "node": ">=22",
+    "pnpm": ">=10"
+  },
+  "author": {
+    "name": "GraffitoRyu",
+    "email": "yth4135@naver.com",
+    "url": "https://github.com/GraffitoRyu"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "util-next:build": "pnpm run build",
+    "util-next:dev": "pnpm run dev"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.mjs",
+      "require": "./dist/server.cjs",
+      "default": "./dist/server.mjs"
+    }
+  },
+  "dependencies": {
+    "@uniai-fe/util-functions": "workspace:*"
+  },
+  "peerDependencies": {
+    "next": ">= 15"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.30",
+    "@uniai-fe/eslint-config": "workspace:*",
+    "@uniai-fe/tsconfig": "workspace:*",
+    "eslint": "^9.38.0",
+    "prettier": "^3.6.2",
+    "tsup": "^8.5.0",
+    "typescript": "~5.9.3"
+  }
+}