// dweb.config.ts
export default {
  routes: {
    dir: 'routes',
    // API 路由模式：'method'（方法路由，默认）或 'restful'（RESTful API）
    apiMode: 'method' // 或 'restful'
  }
};

// routes/api/users.ts
import type { ApiContext } from '@dreamer/dweb';

/**
 * Method 模式：通过 URL 路径指定方法名
 * 访问方式：POST /api/users/get-user
 * 注意：URL 必须使用中划线格式（kebab-case），函数名可以使用驼峰格式（camelCase）
 */
export function getUser({ res }: ApiContext) {
  const users = [
    { id: 1, name: 'Alice' },
    { id: 2, name: 'Bob' }
  ];
  return res.json({
    success: true,
    data: users
  });
}

/**
 * 访问方式：POST /api/users/create-user
 */
export function createUser({ req, res }: ApiContext) {
  const body = req.body as { name?: string; email?: string };
  const newUser = {
    id: Date.now(),
    name: body?.name || 'Unknown',
    email: body?.email || ''
  };
  return res.json({
    success: true,
    data: newUser
  });
}

/**
 * 访问方式：POST /api/users/get-user-by-id
 * 使用路由参数：/api/users/[id]/get-user-by-id
 */
export function getUserById({ params, res }: ApiContext) {
  const id = params.id;
  const user = { id, name: 'User ' + id };
  return res.json({
    success: true,
    data: user
  });
}

# ✅ 正确：使用中划线格式
curl -X POST http://localhost:3000/api/users/get-user

# ❌ 错误：使用驼峰格式会返回 400 错误
curl -X POST http://localhost:3000/api/users/getUser

# ✅ 正确：创建用户
curl -X POST http://localhost:3000/api/users/create-user \
  -H "Content-Type: application/json" \
  -d '{"name":"John","email":"[email protected]"}'

// routes/api/users.ts
import type { ApiContext } from '@dreamer/dweb';

/**
 * ApiContext 包含以下属性：
 * - req: Request - 请求对象
 * - res: Response - 响应对象
 * - app: ApplicationLike - Application 实例（用于访问服务容器等）
 * - cookie: Record<string, string> - Cookie 对象
 * - session: Session | null - Session 对象（如果存在）
 * - params: Record<string, string> - 路由参数
 * - query: Record<string, string> - 查询参数
 * - routePath: string - 当前路由路径
 * - url: URL - URL 对象
 */
export function getUser({ 
  req,      // 请求对象
  res,      // 响应对象
  app,      // Application 实例
  cookie,   // Cookie 对象
  session,  // Session 对象
  params,   // 路由参数
  query,    // 查询参数
  routePath,// 当前路由路径
  url       // URL 对象
}: ApiContext) {
  // 从查询参数获取数据
  const userId = query.id;
  
  // 从 Cookie 获取数据
  const token = cookie.token;
  
  // 从 Session 获取数据
  const userIdFromSession = session?.data?.userId;
  
  // 使用 Application 实例获取服务
  const userService = app.getService('userService');
  
  // 返回响应
  return res.json({
    success: true,
    data: {
      userId,
      token,
      userIdFromSession,
      routePath,
      url: url.href
    }
  });
}

// routes/api/users.ts
import type { ApiContext } from '@dreamer/dweb';

/**
 * 推荐用法：只解构实际使用的属性
 * 这样代码更简洁，也更容易理解
 */

// 只使用 res
export function getUsers({ res }: ApiContext) {
  return res.json({
    success: true,
    data: []
  });
}

// 使用 params 和 res
export function getUser({ params, res }: ApiContext) {
  const id = params.id;
  return res.json({
    success: true,
    data: { id }
  });
}

// 使用 req, res 和 app
export function createUser({ req, res, app }: ApiContext) {
  const body = req.body as { name?: string };
  const userService = app.getService('userService');
  // 创建用户...
  return res.json({
    success: true,
    data: { name: body?.name }
  });
}

// 使用 query 和 res
export function searchUsers({ query, res }: ApiContext) {
  const keyword = query.keyword;
  return res.json({
    success: true,
    data: { keyword }
  });
}