@uniai-fe/uds-templates 0.3.2 → 0.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniai-fe/uds-templates",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "UNIAI Design System; UI Templates Package",
   "type": "module",
   "private": false,
@@ -52,6 +52,7 @@
     "@tanstack/react-query": "^5",
     "@uniai-fe/uds-foundation": "^0.1.0",
     "@uniai-fe/uds-primitives": "^0.1.0",
+    "@uniai-fe/util-api": "^0.1.0",
     "@uniai-fe/util-functions": "^0.2.0",
     "@uniai-fe/util-jotai": "^0.1.5",
     "@uniai-fe/util-next": "^0.2.0",
@@ -78,6 +79,7 @@
     "@uniai-fe/tsconfig": "workspace:*",
     "@uniai-fe/uds-foundation": "workspace:*",
     "@uniai-fe/uds-primitives": "workspace:*",
+    "@uniai-fe/util-api": "workspace:*",
     "@uniai-fe/util-functions": "workspace:*",
     "@uniai-fe/util-jotai": "workspace:*",
     "@uniai-fe/util-next": "workspace:*",

package/src/types/api.ts

@@ -1,65 +1,39 @@
+import type {
+  API_Res_Base as UtilAPI_Res_Base,
+  API_Res_Error as UtilAPI_Res_Error,
+  API_Res_Pagination as UtilAPI_Res_Pagination,
+  API_Res_Status as UtilAPI_Res_Status,
+} from "@uniai-fe/util-api";
+
+/**
+ * 변경: API 공통 타입 SOT를 @uniai-fe/util-api 패키지로 단일화한다.
+ * 기존 templates 경로 import 호환을 위해 타입 alias를 유지한다.
+ * @deprecated `@uniai-fe/util-api`의 `API_Res_Error`를 직접 import 해서 사용할 것.
+ * @see packages/util/api/src/response/index.ts
+ */
+export type API_Res_Error = UtilAPI_Res_Error;
+
 /**
- * API 응답; 에러 정보
- * @property {string} field_name - 에러 필드 이름
- * @property {string} message - 에러 메세지
+ * 변경: API 공통 타입 SOT를 @uniai-fe/util-api 패키지로 단일화한다.
+ * 기존 templates 경로 import 호환을 위해 타입 alias를 유지한다.
+ * @deprecated `@uniai-fe/util-api`의 `API_Res_Status`를 직접 import 해서 사용할 것.
+ * @see packages/util/api/src/response/index.ts
  */
-export interface API_Res_Error {
-  /**
-   * 에러 필드 이름
-   */
-  field_name: string;
-  /**
-   * 에러 메세지
-   */
-  message: string;
-}
+export type API_Res_Status = UtilAPI_Res_Status;
 
 /**
- * API 응답; 기본 구조
- * - GET, POST, PUT, DELETE 등 모든 API 응답에 공통적으로 사용
- * @property {string} status - 통신 상태
- * - "success": 정상 응답
- * - "fail": 비정상 응답
- * - "timeout": 타임아웃 응답
- * @property {ResultDataType} data - 요청 응답 데이터
- * @property {API_Res_Error[]} errors - 에러 정보
+ * 변경: API 공통 타입 SOT를 @uniai-fe/util-api 패키지로 단일화한다.
+ * 기존 templates 경로 import 호환을 위해 타입 alias를 유지한다.
+ * @deprecated `@uniai-fe/util-api`의 `API_Res_Base`를 직접 import 해서 사용할 것.
+ * @see packages/util/api/src/response/index.ts
  */
-export interface API_Res_Base<ResultDataType> {
-  /**
-   * 통신 상태
-   * - "success": 정상 응답
-   * - "fail": 비정상 응답
-   * - "timeout": 타임아웃 응답
-   */
-  status: string;
-  /**
-   * 요청 응답 데이터
-   */
-  data: ResultDataType;
-  /**
-   * 에러 정보
-   */
-  errors: API_Res_Error[];
-}
+export type API_Res_Base<ResultDataType> = UtilAPI_Res_Base<ResultDataType>;
 
 /**
- * API 응답; pagination 정보
- * - Table, Grid 등, page 단위로 존재하는 데이터를 조회할 때 받는 응답값
- * @property {number} total_count 모든 item 개수
- * @property {number} size 화면에 표시할 item 개수
- * @property {Record<string, unknown>} items 각 row item 맵핑 데이터
+ * 변경: API 공통 타입 SOT를 @uniai-fe/util-api 패키지로 단일화한다.
+ * 기존 templates 경로 import 호환을 위해 타입 alias를 유지한다.
+ * @deprecated `@uniai-fe/util-api`의 `API_Res_Pagination`을 직접 import 해서 사용할 것.
+ * @see packages/util/api/src/response/index.ts
  */
-export interface API_Res_Pagination<ItemData extends Record<string, unknown>> {
-  /**
-   * 모든 item 개수
-   */
-  total_count: number;
-  /*
-   * 화면에 표시할 item 개수
-   */
-  size: number;
-  /**
-   * 각 row item 맵핑 데이터
-   */
-  items: ItemData;
-}
+export type API_Res_Pagination<ItemData extends Record<string, unknown>> =
+  UtilAPI_Res_Pagination<ItemData>;