Route Handler 생성

export interface User {
  id: number;
  name: string;
  email: string;
}

export type UserInput = Omit<User, 'id'>;

let users: User[] = [
  { id: 1, name: '김철수', email: 'chulsoo@example.com' },
  { id: 2, name: '이영희', email: 'younghee@example.com' },
  { id: 3, name: '박민수', email: 'minsu@example.com' },
];
let nextId = 4;

export function parseUserId(value: string): number | null {
  if (!/^\d+$/.test(value)) return null;
  const id = Number(value);
  return Number.isSafeInteger(id) && id > 0 ? id : null;
}

export function parseUserInput(value: unknown): UserInput | null {
  if (typeof value !== 'object' || value === null || Array.isArray(value)) return null;

  const { name, email } = value as Record<string, unknown>;
  if (typeof name !== 'string' || typeof email !== 'string') return null;

  const normalizedName = name.trim();
  const normalizedEmail = email.trim().toLowerCase();
  if (!normalizedName || normalizedName.length > 50) return null;
  if (normalizedEmail.length > 254 || !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(normalizedEmail)) return null;

  return { name: normalizedName, email: normalizedEmail };
}

export function listUsers(search: string | null): User[] {
  return search ? users.filter((user) => user.name.includes(search)) : users;
}

export function findUser(id: number): User | undefined {
  return users.find((user) => user.id === id);
}

export function createUser(input: UserInput): User {
  const user = { id: nextId++, ...input };
  users = [...users, user];
  return user;
}

export function updateUser(id: number, input: UserInput): User | null {
  const index = users.findIndex((user) => user.id === id);
  if (index === -1) return null;

  const user = { id, ...input };
  users = users.map((current) => current.id === id ? user : current);
  return user;
}

export function deleteUser(id: number): boolean {
  const nextUsers = users.filter((user) => user.id !== id);
  if (nextUsers.length === users.length) return false;
  users = nextUsers;
  return true;
}

import { NextRequest, NextResponse } from 'next/server';
import { createUser, listUsers, parseUserInput } from '@/lib/users-repository';

/**
 * GET 요청을 처리하는 핸들러 함수
  * @param request NextRequest 객체 (선택 사항, 쿼리 파라미터 등 접근 시 사용)
  */
export async function GET(request: NextRequest) {
  // 쿼리 파라미터 예시: /api/users?search=김
  const searchParam = request.nextUrl.searchParams.get('search');

  return NextResponse.json(listUsers(searchParam), { status: 200 });
}

export async function POST(request: NextRequest) {
  let body: unknown;

  try {
    body = await request.json();
  } catch {
    return NextResponse.json({ message: '올바른 JSON 본문이 필요합니다.' }, { status: 400 });
  }

  const input = parseUserInput(body);
  if (!input) {
    return NextResponse.json(
      { message: '이름과 이메일 형식을 확인해 주세요.' },
      { status: 400 },
    );
  }

  return NextResponse.json(createUser(input), { status: 201 });
}

curl -X POST \
  http://localhost:3000/api/users \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "새로운 사용자",
    "email": "newuser@example.com"
  }'

import { NextRequest, NextResponse } from 'next/server';
import {
  deleteUser,
  findUser,
  parseUserId,
  parseUserInput,
  updateUser,
} from '@/lib/users-repository';

// 라우트 파라미터 타입 정의
interface Context {
  params: Promise<{ id: string }>;
}

/**
 * 특정 사용자 조회 (GET /api/users/[id])
  * @param request NextRequest 객체
  * @param context 동적 라우트 파라미터 (params.id)
  */
export async function GET(_request: NextRequest, context: Context) {
  const { id: idParam } = await context.params;
  const id = parseUserId(idParam);

  if (id === null) {
    return NextResponse.json({ message: '올바른 사용자 ID가 필요합니다.' }, { status: 400 });
  }
  const user = findUser(id);

  if (!user) {
    return NextResponse.json({ message: '사용자를 찾을 수 없습니다.' }, { status: 404 });
  }

  return NextResponse.json(user, { status: 200 });
}

/**
 * 특정 사용자 업데이트 (PUT /api/users/[id])
  * @param request NextRequest 객체
  * @param context 동적 라우트 파라미터 (params.id)
  */
export async function PUT(request: NextRequest, context: Context) {
  const { id: idParam } = await context.params;
  const id = parseUserId(idParam);

  if (id === null) {
    return NextResponse.json({ message: '올바른 사용자 ID가 필요합니다.' }, { status: 400 });
  }

  let body: unknown;
  try {
    body = await request.json();
  } catch {
    return NextResponse.json({ message: '올바른 JSON 본문이 필요합니다.' }, { status: 400 });
  }

  const input = parseUserInput(body);
  if (!input) {
    return NextResponse.json({ message: '이름과 이메일 형식을 확인해 주세요.' }, { status: 400 });
  }

  const user = updateUser(id, input);
  if (!user) {
    return NextResponse.json({ message: '사용자를 찾을 수 없습니다.' }, { status: 404 });
  }

  return NextResponse.json(user, { status: 200 });
}

/**
 * 특정 사용자 삭제 (DELETE /api/users/[id])
  * @param request NextRequest 객체
  * @param context 동적 라우트 파라미터 (params.id)
  */
export async function DELETE(_request: NextRequest, context: Context) {
  const { id: idParam } = await context.params;
  const id = parseUserId(idParam);

  if (id === null) {
    return NextResponse.json({ message: '올바른 사용자 ID가 필요합니다.' }, { status: 400 });
  }

  if (!deleteUser(id)) {
    return NextResponse.json({ message: '사용자를 찾을 수 없습니다.' }, { status: 404 });
  }

  return NextResponse.json({ message: '사용자가 성공적으로 삭제되었습니다.' }, { status: 200 });
}