유틸리티 타입 — 타입 변환 도구 모음

interface User {
    id: number;
    name: string;
    email: string;
    password: string;
    createdAt: Date;
}

type PartialUser = Partial<User>;
// { id?: number; name?: string; email?: string; ... }

// PATCH 요청: 일부 필드만 업데이트
function updateUser(id: number, changes: Partial<User>): User {
    // changes는 어떤 필드든 있어도 없어도 됨
    return { ...existingUser, ...changes };
}

updateUser(1, { name: "새 이름" });   // ✅
updateUser(1, { email: "new@example.com", name: "새 이름" });  // ✅

interface Config {
    host?: string;
    port?: number;
    debug?: boolean;
}

type RequiredConfig = Required<Config>;
// { host: string; port: number; debug: boolean; }

type ReadonlyUser = Readonly<User>;

const user: ReadonlyUser = {
    id: 1, name: "철수", email: "kim@example.com",
    password: "secret", createdAt: new Date(),
};

// user.name = "영희";  // ❌ 읽기 전용

// 공개 프로필: 민감한 정보 제외
type PublicUser = Pick<User, "id" | "name" | "email">;
// { id: number; name: string; email: string; }

// API 응답에서 필요한 필드만
type UserSummary = Pick<User, "id" | "name">;

// 비밀번호와 생성일 제외
type SafeUser = Omit<User, "password" | "createdAt">;
// { id: number; name: string; email: string; }

// 새 사용자 생성: ID는 서버에서 생성
type CreateUserDto = Omit<User, "id" | "createdAt">;

// 키: string, 값: number인 객체
type ScoreMap = Record<string, number>;
const scores: ScoreMap = { 철수: 85, 영희: 92 };

// 열거형 키
type Status = "active" | "inactive" | "pending";
type StatusLabel = Record<Status, string>;

const labels: StatusLabel = {
    active: "활성",
    inactive: "비활성",
    pending: "대기",
};

type AllStatus = "active" | "inactive" | "pending" | "banned";

// banned를 제외
type NormalStatus = Exclude<AllStatus, "banned">;
// "active" | "inactive" | "pending"

// 특정 상태만 추출
type ActiveOrPending = Extract<AllStatus, "active" | "pending">;
// "active" | "pending"

function fetchUser(id: number, token: string): Promise<User> {
    return fetch(`/api/users/${id}`).then(r => r.json());
}

// 함수 반환 타입 추출
type FetchUserReturn = ReturnType<typeof fetchUser>;
// Promise<User>

// 함수 매개변수 타입 추출
type FetchUserParams = Parameters<typeof fetchUser>;
// [id: number, token: string]

// CRUD 작업에서 자주 쓰는 패턴
interface Product {
    id: string;
    name: string;
    price: number;
    stock: number;
    createdAt: Date;
    updatedAt: Date;
}

// 생성: id, 날짜는 서버에서 생성
type CreateProductDto = Omit<Product, "id" | "createdAt" | "updatedAt">;

// 수정: 모든 필드 선택적 (id는 경로 파라미터로)
type UpdateProductDto = Partial<Omit<Product, "id" | "createdAt" | "updatedAt">>;

// 응답: 전체
type ProductResponse = Readonly<Product>;

// 목록: 일부만
type ProductSummary = Pick<Product, "id" | "name" | "price">;