HTTP 메서드 처리

import { NextRequest, NextResponse } from 'next/server';

export async function GET(request: NextRequest) {
  // GET 요청 처리 로직
  return NextResponse.json({ message: 'GET request received' });
}

export async function POST(request: NextRequest) {
  // POST 요청 처리 로직
  const data = await request.json();
  return NextResponse.json({ message: 'POST request received', data });
}

export async function PUT(request: NextRequest) {
  // PUT 요청 처리 로직
  const data = await request.json();
  return NextResponse.json({ message: 'PUT request received', data });
}

export async function DELETE(request: NextRequest) {
  // DELETE 요청 처리 로직
  return NextResponse.json({ message: 'DELETE request received' });
}

// 기타 메서드도 동일하게 export 할 수 있습니다.
// export async function PATCH(request: NextRequest) { ... }
// export async function HEAD(request: NextRequest) { ... }
// export async function OPTIONS(request: NextRequest) { ... }

// NextRequest 활용 예시
import { NextRequest, NextResponse } from 'next/server';

export async function GET(request: NextRequest) {
  const url = request.url; // 예: http://localhost:3000/api/data?name=test
  const method = request.method; // 'GET'
  const contentType = request.headers.get('Content-Type'); // 요청 헤더 접근
  const myCookie = request.cookies.get('my_cookie')?.value; // 쿠키 접근
  const nameParam = request.nextUrl.searchParams.get('name'); // 쿼리 파라미터 접근

  return NextResponse.json({
    url,
    method,
    contentType,
    myCookie,
    nameParam,
  });
}

export async function POST(request: NextRequest) {
  const body = await request.json(); // JSON 본문 파싱
  // const textBody = await request.text(); // 텍스트 본문 파싱

  return NextResponse.json({
    message: 'Data received',
    receivedBody: body,
  });
}

// NextResponse 활용 예시
import { NextRequest, NextResponse } from 'next/server';

export async function GET(request: NextRequest) {
  // 200 OK 상태 코드와 JSON 데이터 반환
  return NextResponse.json({ data: '성공적으로 데이터를 가져왔습니다.' }, { status: 200 });
}

export async function POST(request: NextRequest) {
  // 201 Created 상태 코드와 커스텀 헤더 설정
  const newUser = { id: 1, name: '새 사용자' };
  return NextResponse.json(newUser, {
    status: 201,
    headers: {
      'X-Custom-Header': 'Next.js API',
      'Location': `/api/users/${newUser.id}`, // 생성된 리소스의 위치
    },
  });
}

export async function DELETE(request: NextRequest) {
  // 404 Not Found 상태 코드와 오류 메시지
  const id = request.nextUrl.searchParams.get('id');
  if (id === 'invalid') {
    return NextResponse.json({ message: '리소스를 찾을 수 없습니다.' }, { status: 404 });
  }
  // 204 No Content (성공적으로 처리했지만 반환할 내용이 없을 때)
  return new NextResponse(null, { status: 204 });
}

import { NextRequest, NextResponse } from 'next/server';

// 가상의 사용자 데이터 (실제로는 데이터베이스)
// 🚨 중요: 이 예제는 서버가 재시작되면 데이터가 초기화됩니다.
// 실제 애플리케이션에서는 반드시 데이터베이스를 사용해야 합니다.
let users = [
  { id: 1, name: '김철수', email: 'chulsoo@example.com' },
  { id: 2, name: '이영희', email: 'younghee@example.com' },
  { id: 3, name: '박민수', email: 'minsu@example.com' },
];

type UserFields = { name: string; email: string };

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

function normalizeName(value: unknown): string | null {
  if (typeof value !== 'string') return null;
  const name = value.trim();
  return name && name.length <= 50 ? name : null;
}

function normalizeEmail(value: unknown): string | null {
  if (typeof value !== 'string') return null;
  const email = value.trim().toLowerCase();
  return email.length <= 254 && /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)
    ? email
    : null;
}

function parseFullUser(value: unknown): UserFields | null {
  if (typeof value !== 'object' || value === null || Array.isArray(value)) return null;
  const record = value as Record<string, unknown>;
  const name = normalizeName(record.name);
  const email = normalizeEmail(record.email);
  return name && email ? { name, email } : null;
}

function parseUserPatch(value: unknown): Partial<UserFields> | null {
  if (typeof value !== 'object' || value === null || Array.isArray(value)) return null;

  const record = value as Record<string, unknown>;
  const keys = Object.keys(record);
  if (keys.length === 0 || keys.some((key) => key !== 'name' && key !== 'email')) return null;

  const patch: Partial<UserFields> = {};
  if ('name' in record) {
    const name = normalizeName(record.name);
    if (!name) return null;
    patch.name = name;
  }
  if ('email' in record) {
    const email = normalizeEmail(record.email);
    if (!email) return null;
    patch.email = email;
  }
  return patch;
}

// 동적 라우트 파라미터 타입을 위한 인터페이스
interface Context {
  params: Promise<{ id: string }>;
}

/**
 * GET /api/users/[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 = users.find(u => u.id === id);

  if (!user) {
    // 사용자를 찾지 못한 경우 404 Not Found 응답
    return NextResponse.json({ message: '사용자를 찾을 수 없습니다.' }, { status: 404 });
  }

  // 성공적으로 사용자를 찾은 경우 200 OK 응답
  return NextResponse.json(user, { status: 200 });
}

/**
 * PUT /api/users/[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 = parseFullUser(body);
  if (!input) {
    return NextResponse.json({ message: '이름과 이메일 형식을 확인해 주세요.' }, { status: 400 });
  }

  const userIndex = users.findIndex(u => u.id === id);

  if (userIndex === -1) {
    // 사용자를 찾지 못한 경우 404 Not Found 응답
    return NextResponse.json({ message: '사용자를 찾을 수 없습니다.' }, { status: 404 });
  }

  // 사용자 정보 업데이트 (불변성을 유지하며 새로운 배열 생성)
  users = users.map(user =>
    user.id === id ? { ...user, ...input } : user
  );

  // 업데이트된 사용자 정보와 함께 200 OK 응답
  return NextResponse.json(users[userIndex], { status: 200 });
}

/**
 * PATCH /api/users/[id] - 특정 사용자 부분 업데이트
 */
export async function PATCH(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 patch = parseUserPatch(body);
  if (!patch) {
    return NextResponse.json({ message: '변경할 이름 또는 이메일 형식을 확인해 주세요.' }, { status: 400 });
  }

  const userIndex = users.findIndex(u => u.id === id);

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

  // 기존 사용자 정보를 가져와서 전달된 필드만 업데이트
  const existingUser = users[userIndex];
  const updatedUser = {
    ...existingUser,
    ...patch,
  };

  users[userIndex] = updatedUser; // 배열 직접 수정 또는 새로운 배열 생성 방식 선택

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

/**
 * DELETE /api/users/[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 });
  }

  const initialLength = users.length;
  // 사용자 삭제 (불변성을 유지하며 새로운 배열 생성)
  users = users.filter(u => u.id !== id);

  if (users.length === initialLength) {
    // 삭제할 사용자를 찾지 못한 경우 404 Not Found 응답
    return NextResponse.json({ message: '사용자를 찾을 수 없습니다.' }, { status: 404 });
  }

  // 성공적으로 삭제된 경우 200 OK 또는 204 No Content 응답
  return NextResponse.json({ message: '사용자가 성공적으로 삭제되었습니다.' }, { status: 200 });
  // return new NextResponse(null, { status: 204 }); // 204는 본문이 없음
}