// file: src/api/users.routes.js
import { Router } from 'express';

// 1. 创建一个新的路由实例
const router = Router();

// 2. 在这个 router 实例上定义路由
// 注意：这里的路径是相对于它被挂载的路径
router.get('/', (req, res) => {
  res.json({ message: 'GET /users - 获取所有用户' });
});

router.post('/', (req, res) => {
  res.status(201).json({ message: 'POST /users - 创建新用户' });
});

router.get('/:id', (req, res) => {
  res.json({ message: `GET /users/${req.params.id} - 获取单个用户` });
});

// 3. 导出 router
export default router;

// file: src/app.js
import express from 'express';
import usersRouter from './api/users.routes.js'; // 导入用户路由

const app = express();
const PORT = 3000;

app.use(express.json());

// 3. 将用户路由挂载到 /api/v1/users 前缀下
// 所有来自 './api/users.routes.js' 的路由都会自动加上这个前缀
// 例如: router.get('/') 实际对应的 URL 是 GET /api/v1/users
app.use('/api/v1/users', usersRouter);

// ...可以继续挂载其他路由，如 productsRouter

app.listen(PORT, () => {
  console.log(`🚀 服务器已启动，正在监听 http://localhost:${PORT}`);
});

// file: src/api/users.routes.js (文件顶部)
import { Router } from 'express';
import { z } from 'zod'; // 导入 zod

// 定义创建用户时的验证 schema
const createUserSchema = z.object({
  body: z.object({
    // username 必须是字符串，且最小长度为 3
    username: z.string().min(3, {
      message: "用户名长度不能少于3个字符"
    }),
    // email 必须是字符串，且符合 email 格式
    email: z.string().email({
      message: "请输入有效的邮箱地址"
    }),
    // password 必须是字符串，最小 6 位，最大 100 位
    password: z.string().min(6).max(100),
    // age 是数字，且是可选的
    age: z.number().optional(),
  }),
  query: z.object({}).optional(),
  params: z.object({}).optional(),
});

// file: src/middlewares/validate.js
import { ZodError } from 'zod';

// 这是一个高阶函数：它接收一个 schema，返回一个中间件函数
const validate = (schema) => (req, res, next) => {
  try {
    // 使用 zod 的 parse 方法进行验证
    // 如果验证通过，什么都不会发生，请求会继续
    schema.parse({
      body: req.body,
      query: req.query,
      params: req.params,
    });
    next();
  } catch (error) {
    // 如果验证失败, zod 会抛出一个 ZodError
    // 我们将这个错误传递给 next()，由全局错误处理器来处理
    next(error);
  }
};

export default validate;

// file: src/middlewares/errorHandler.js
import {
  ZodError
} from 'zod';

const errorHandler = (err, req, res, next) => {
  // 判断错误是否是 Zod 验证错误
  if (err instanceof ZodError) {
    console.error('Zod错误详情:', err.issues); // 打印Zod错误详情
    // 如果是，返回 400 状态码和格式化后的错误信息
    return res.status(400).json({
      error: "输入数据无效",
      issues: (err.issues || []).map(issue => ({
        path: issue.path ? issue.path.join('.') : 'unknown',
        message: issue.message || '未知错误',
      })),
    });
  }

  // 对于其他所有类型的错误，打印错误详情并返回一个通用的 500 服务器错误
  console.error('服务器错误详情:', err);
  res.status(500).json({
    error: "服务器内部错误",
    details: process.env.NODE_ENV === 'development' ? err.message : undefined
  });
};

export default errorHandler;

// file: src/app.js
// ... 其他 imports
import errorHandler from './middlewares/errorHandler.js'; // 导入错误处理器

// ... app.use(express.json()) 和 app.use('/api/v1/users', ...)

// !!! 关键：错误处理中间件必须在所有路由和普通中间件之后定义
app.use(errorHandler);

app.listen(PORT, ...);

// file: src/api/users.routes.js
// ... 其他 imports
import validate from '../middlewares/validate.js'; // 导入验证中间件

// ... 定义 createUserSchema 和 router

// 将 validate(createUserSchema) 作为路由的中间件
router.post('/', validate(createUserSchema), (req, res) => {
  // 如果代码能执行到这里，说明数据验证已经通过
  const { username } = req.body;
  res.status(201).json({ message: `用户 ${username} 创建成功`, data: req.body });
});

export default router;