refactor: 引入 apiHandler + ApiError，消除 20 个路由的 try/catch 样板

- 新增 src/lib/api.ts：ApiError 错误类 + apiHandler 统一包装器
- 20 个 API 路由统一使用 apiHandler，删除重复的 try/catch 块
- 验证错误改用 throw new ApiError()，减少嵌套层级
- join/manage 路由的错误码映射改为直接抛出 ApiError
- 删除已无引用的 errorResponse 辅助函数
- 净减 273 行代码

src/app/api/room/[id]/manage/route.ts

@@ -1,106 +1,73 @@
 import { NextResponse } from "next/server";
 import { atomicUpdateRoom } from "@/lib/store";
 import { notify } from "@/lib/roomEvents";
+import { apiHandler, ApiError } from "@/lib/api";
 
-export async function POST(
-  req: Request,
-  { params }: { params: Promise<{ id: string }> },
-) {
+export const POST = apiHandler(async (req, { params }) => {
   const { id } = await params;
+  const { userId, action, targetUserId } = await req.json();
 
-  try {
-    const { userId, action, targetUserId } = await req.json();
-    if (!userId || !action) {
-      return NextResponse.json(
-        { error: "userId and action required" },
-        { status: 400 },
-      );
+  if (!userId || !action) {
+    throw new ApiError("userId and action required");
+  }
+
+  const updated = await atomicUpdateRoom(id, (data) => {
+    if (data.creatorId !== userId) {
+      throw new ApiError("只有房主可以执行此操作", 403);
     }
 
-    const updated = await atomicUpdateRoom(id, (data) => {
-      if (data.creatorId !== userId) {
-        throw new Error("FORBIDDEN");
-      }
+    switch (action) {
+      case "lock":
+        data.locked = true;
+        break;
 
-      switch (action) {
-        case "lock":
-          data.locked = true;
-          break;
+      case "unlock":
+        data.locked = false;
+        break;
 
-        case "unlock":
-          data.locked = false;
-          break;
+      case "kick":
+        if (!targetUserId || targetUserId === userId) {
+          throw new ApiError("无效的操作对象");
+        }
+        data.users = data.users.filter((u) => u !== targetUserId);
+        if (!data.kickedUsers.includes(targetUserId)) {
+          data.kickedUsers.push(targetUserId);
+        }
+        delete data.swipeCounts[targetUserId];
+        for (const rid of Object.keys(data.likes)) {
+          data.likes[rid] = data.likes[rid].filter(
+            (u) => u !== targetUserId,
+          );
+        }
+        if (
+          data.match &&
+          data.likes[data.match]?.length !== data.users.length
+        ) {
+          data.match = null;
+        }
+        break;
 
-        case "kick":
-          if (!targetUserId || targetUserId === userId) {
-            throw new Error("INVALID_TARGET");
-          }
-          data.users = data.users.filter((u) => u !== targetUserId);
-          if (!data.kickedUsers.includes(targetUserId)) {
-            data.kickedUsers.push(targetUserId);
-          }
-          delete data.swipeCounts[targetUserId];
-          for (const rid of Object.keys(data.likes)) {
-            data.likes[rid] = data.likes[rid].filter(
-              (u) => u !== targetUserId,
-            );
-          }
-          if (
-            data.match &&
-            data.likes[data.match]?.length !== data.users.length
-          ) {
-            data.match = null;
-          }
-          break;
+      case "end_voting":
+        for (const u of data.users) {
+          data.swipeCounts[u] = data.restaurants.length;
+        }
+        break;
 
-        case "end_voting":
-          for (const u of data.users) {
-            data.swipeCounts[u] = data.restaurants.length;
-          }
-          break;
-
-        default:
-          throw new Error("UNKNOWN_ACTION");
-      }
-
-      return data;
-    });
-
-    if (!updated) {
-      return NextResponse.json(
-        { error: "房间不存在或已过期" },
-        { status: 404 },
-      );
+      default:
+        throw new ApiError("未知操作");
     }
 
-    notify(id);
+    return data;
+  });
 
-    return NextResponse.json({ ok: true });
-  } catch (e) {
-    if (e instanceof Error) {
-      if (e.message === "FORBIDDEN") {
-        return NextResponse.json(
-          { error: "只有房主可以执行此操作" },
-          { status: 403 },
-        );
-      }
-      if (e.message === "INVALID_TARGET") {
-        return NextResponse.json(
-          { error: "无效的操作对象" },
-          { status: 400 },
-        );
-      }
-      if (e.message === "UNKNOWN_ACTION") {
-        return NextResponse.json(
-          { error: "未知操作" },
-          { status: 400 },
-        );
-      }
-    }
-    console.error("Failed to manage room:", e);
+  if (!updated) {
     return NextResponse.json(
-      { error: "操作失败" },
-      { status: 500 },
+      { error: "房间不存在或已过期" },
+      { status: 404 },
     );
   }
-}
+
+  notify(id);
+
+  return NextResponse.json({ ok: true });
+});