feat: expand item types and improve API response handling

- Added new interfaces and types for ItemsPublic, ItemResponse, and ItemsResponse to enhance type safety and clarity in API interactions.
- Updated the index file to export the new types for broader accessibility.
- Refactored the ItemsTable component to utilize the new response structure, improving data handling and reducing type assertions.

Author: cubxxw

admin/src/client/index.ts

@@ -5,4 +5,4 @@ export { OpenAPI, type OpenAPIConfig } from "./core/OpenAPI"
 export * from "./sdk.gen"
 export * from "./types.gen"
 export { isApiResponse, extractApiResponseError } from "./utils"
-export { type ItemPublic } from "./types"
+export { type ItemPublic, type ItemsPublic, type ItemResponse, type ItemsResponse } from "./types"

admin/src/client/types.ts

@@ -9,4 +9,30 @@ export interface ItemPublic {
   id: string;
   title: string;
   description?: string | null;
-} 
+} 
+
+/**
+ * 项目集合的公共接口定义
+ */
+export interface ItemsPublic {
+  data: Array<ItemPublic>;
+  count: number;
+}
+
+/**
+ * 从API响应中提取Item数据的类型
+ */
+export type ItemResponse = {
+  data: ItemPublic;
+  meta?: Record<string, unknown> | null;
+  error?: string | null;
+};
+
+/**
+ * 从API响应中提取Items集合数据的类型
+ */
+export type ItemsResponse = {
+  data: ItemsPublic;
+  meta?: Record<string, unknown> | null;
+  error?: string | null;
+}; 

admin/src/routes/_layout/items.tsx

@@ -11,7 +11,7 @@ import { createFileRoute, useNavigate } from "@tanstack/react-router"
 import { FiSearch } from "react-icons/fi"
 import { z } from "zod"
 
-import { type ItemPublic, ItemsService } from "@/client"
+import { type ItemPublic, type ItemsResponse, ItemsService } from "@/client"
 import { ItemActionsMenu } from "@/components/Common/ItemActionsMenu"
 import AddItem from "@/components/Items/AddItem"
 import PendingItems from "@/components/Pending/PendingItems"
@@ -60,17 +60,8 @@ function ItemsTable() {
     })
 
   // 安全地处理API响应
-  const apiData = apiResponse?.data || ({} as any)
-
-  // 使用类型断言处理响应数据
-  const items: ItemPublic[] = Array.isArray(apiData.data)
-    ? apiData.data
-    : Array.isArray(apiData)
-      ? apiData
-      : []
-
-  // 使用类型断言处理计数
-  const count = typeof apiData.count === "number" ? apiData.count : items.length
+  const items: ItemPublic[] = apiResponse?.data?.data?.data || [];
+  const count = apiResponse?.data?.data?.count || 0;
 
   if (isLoading) {
     return <PendingItems />