@uniai-fe/util-functions 0.0.1

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@uniai-fe/util-functions",
+  "version": "0.0.1",
+  "type": "module",
+  "description": "유니아이 FE/유틸리티 함수",
+  "author": "GraffitoRyu <@uniai-corp>(https://github.com/GraffitoRyu)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/uniai-corp/modules"
+  },
+  "scripts": {},
+  "files": [
+    "src"
+  ],
+  "main": "./src/index.tsx",
+  "module": "./src/index.tsx",
+  "exports": {
+    ".": "./src/index.tsx",
+    "./api": "./src/functions/api.ts",
+    "./api.server": "./src/functions/api.server.ts",
+    "./chart": "./src/functions/chart.ts",
+    "./convert": "./src/functions/convert.ts",
+    "./date": "./src/functions/date.ts",
+    "./file": "./src/functions/file.ts",
+    "./format": "./src/functions/format.ts",
+    "./log": "./src/functions/log.ts",
+    "./mask": "./src/functions/mask.ts",
+    "./reg-exp": "./src/functions/reg-exp.ts",
+    "./route": "./src/functions/route.ts",
+    "./sort": "./src/functions/sort.ts",
+    "./validation": "./src/functions/validation.ts",
+    "./checkbox": "./src/form/checkbox.ts",
+    "./react/convert": "./src/react/convert.tsx",
+    "./react/match": "./src/react/match.tsx",
+    "./style/size": "./src/style/size.ts"
+  },
+  "peerDependencies": {
+    "next": ">= 15",
+    "react": ">= 19",
+    "react-dom": ">= 19"
+  },
+  "dependencies": {
+    "d3-array": "^3.2.4",
+    "decimal.js": "^10.6.0",
+    "html-react-parser": "^5.2.7"
+  },
+  "devDependencies": {
+    "@types/d3-array": "^3.2.2",
+    "@types/node": "^22.15.30",
+    "@types/react": "^19.2.2",
+    "@types/react-dom": "^19.2.2",
+    "@uniai-fe/eslint-config": "workspace:*",
+    "@uniai-fe/tsconfig": "workspace:*",
+    "eslint": "^9.38.0",
+    "next": "^15.5.6",
+    "prettier": "^3.6.2",
+    "recharts": "^3.3.0",
+    "typescript": "~5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/form/checkbox.ts

@@ -0,0 +1,41 @@
+/**
+ * "전체" 항목 선택에 따른 단일 항목 업데이트
+ * @util
+ * @param {Record<string, boolean>} checkStateObject 체크 상태관리 객체
+ * @param {boolean} allCheckState 동기화할 "전체" 선택 상태
+ * @return {Record<string, boolean>} 업데이트된 체크 상태관리 객체
+ */
+export const syncAllToEach = (
+  checkStateObject: Record<string, boolean>,
+  allCheckState: boolean,
+): Record<string, boolean> =>
+  Object.fromEntries(
+    Object.entries(checkStateObject).map(([key]) => [key, allCheckState]),
+  );
+
+/**
+ * 단일 항목 선택에 따른 "전체" 항목 업데이트
+ * @util
+ * @param {Record<string, boolean>} checkStateObject 체크 상태관리 객체
+ * @param {string} eachKey 선택한 단일 항목 키
+ * @param {boolean} eachChecked 선택한 단일 항목 선택 상태
+ * @return {Record<string, boolean>} 업데이트된 체크 상태관리 객체
+ */
+export const syncEachToAll = (
+  checkStateObject: Record<string, boolean>,
+  eachKey: string,
+  eachChecked: boolean,
+): Record<string, boolean> => {
+  const res = { ...checkStateObject, [eachKey]: eachChecked };
+  const exceptStateAll = Object.entries(res)
+    .filter(([key]) => key !== "all")
+    .map(([, checked]) => checked);
+
+  const isAllEachChecked = Object.values(exceptStateAll).every(
+    checked => checked,
+  );
+
+  res.all = isAllEachChecked;
+
+  return res;
+};

package/src/functions/api.server.ts

@@ -0,0 +1,114 @@
+"use server";
+
+import { headers } from "next/headers";
+import { NextResponse } from "next/server";
+import { getQueryString } from "./api";
+
+/**
+ * 서버 환경의 현재 요청 헤더에서 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
+ */
+
+export async function setTokenRequestHeaders(): Promise<
+  HeadersInit | undefined
+> {
+  const nextHeaders = await headers();
+  const token = nextHeaders.get("Authorization") || "";
+  if (!token) return undefined;
+  return new Headers({
+    Authorization: token,
+  });
+}
+
+/**
+ * 유니아이 백엔드 디버깅을 위한 응답 헤더 커스텀 설정
+ * @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>} 설정된 응답 객체
+ */
+export async function setDebugResponseHeaders<ResponseData>({
+  res,
+  infra,
+  queryUrl,
+  queryString,
+  searchParams,
+  fullUrl,
+  options,
+}: {
+  /**
+   * fetch 응답 데이터
+   */
+  res: ResponseData;
+  /**
+   * API 도메인
+   * - "ai"(ai-service), "db"(chickenmonger CRUD), "uniai"
+   * - 커스텀 도메인을 쓰는 경우 string으로 직접 적용
+   */
+  infra: string;
+  /**
+   * API 엔드포인트 쿼리 path
+   */
+  queryUrl: string;
+} & Partial<{
+  /**
+   * 쿼리스트링
+   */
+  queryString: string;
+  /**
+   * URLSearchParams 객체
+   */
+  searchParams: URLSearchParams | object;
+  /**
+   * 전체 URL
+   */
+  fullUrl: string;
+  /**
+   * 응답 옵션
+   */
+  options: ResponseInit;
+}>): Promise<NextResponse<ResponseData>> {
+  const response = NextResponse.json(res, options);
+
+  const root: { [infra: string]: string } = {
+    ai: process.env.AI_API_BASE || "not found", //  "https://ai-api.chickenmonger.com",
+    db: process.env.DB_API_BASE || "not found", // "https://api.chickenmonger.com",
+    uniai: process.env.UNIAI_API_BASE || "https://qa-api.uniai.co.kr", //  "not found",
+  };
+
+  const isEnvExist =
+    !root[infra] ||
+    root[infra] === "not found" ||
+    (infra === "uniai" && process.env.UNIAI_API_BASE)
+      ? false
+      : true;
+
+  response.headers.set("Uniai-Native-Domain-Env-Exist", String(isEnvExist));
+  response.headers.set("Uniai-Native-Domain", root[infra] || infra);
+  response.headers.set("Uniai-Native-Path", queryUrl);
+
+  const url =
+    fullUrl ||
+    `${root[infra] || infra || ""}${queryUrl || ""}${queryString || searchParams ? getQueryString(searchParams) : ""}`;
+  response.headers.set("Uniai-Native-URL", url);
+
+  return response;
+}