Subset이란?

// ❌ 문제 1: 목록 조회 - 너무 많은 데이터
const users = await db.table("users").selectAll();
// → 모든 컬럼을 가져옴 (password, bio, 불필요한 정보 포함)

// ❌ 문제 2: 상세 조회 - 관계 데이터 로딩 복잡
const user = await db.table("users").where("id", 1).first();
const employee = await db.table("employees").where("user_id", user.id).first();
const department = await db.table("departments").where("id", employee.department_id).first();
// → N+1 문제, 코드 중복

// ❌ 문제 3: 타입 안전성 부족
type UserList = {
  id: number;
  username: string;
  role: string;
}; // 수동으로 타입 정의 필요

// ✅ Subset A: 전체 정보
const admin = await UserModel.findById(1, ["A"]);
// 타입: { id, created_at, email, username, role, bio, ... }

// ✅ Subset P: 프로필 + 관계
const profile = await UserModel.findById(1, ["P"]);
// 타입: { id, username, employee: { salary, department: { name } } }

// ✅ Subset SS: 요약 정보
const summary = await UserModel.findById(1, ["SS"]);
// 타입: { id, username, role, last_login_at }

{
  "subsets": {
    "A": ["id", "username", "email", "role"],
    "P": ["id", "username", "employee.department.name"],
    "SS": ["id", "username"]
  }
}

// Loader 정의 (자동 생성됨)
const loaders = {
  employees: {
    as: "employees",
    refId: "department_id",
    qb: (qb, fromIds) => 
      qb.table("employees")
        .whereIn("department_id", fromIds)
        .select({ id: "id", name: "username" }),
  },
};

// Flat 결과 (DB에서 조회)
{
  id: 1,
  username: "john",
  employee__department__name: "Engineering"
}

// ↓ Hydrate 변환

// 중첩 객체 (최종 결과)
{
  id: 1,
  username: "john",
  employee: {
    department: {
      name: "Engineering"
    }
  }
}

// GET /users - 사용자 목록
async list(params: UserListParams) {
  const users = await UserModel.findMany({
    listParams: params,
    subsetKey: "L",  // List Subset 사용
  });
  
  // 타입: { id: number; username: string; role: string; created_at: Date }[]
  return users.map(user => ({
    id: user.id,
    username: user.username,
    role: user.role,
    createdAt: user.created_at,
  }));
}

// GET /users/:id/profile
async getProfile(userId: number) {
  const user = await UserModel.findById(userId, ["P"]);
  
  if (!user) {
    throw new Error("User not found");
  }
  
  // 타입: {
  //   id: number;
  //   username: string;
  //   employee: {
  //     salary: string;
  //     department: { name: string }
  //   }
  // }
  
  return {
    id: user.id,
    username: user.username,
    department: user.employee?.department?.name,
    salary: user.employee?.salary,
  };
}

// ✅ Subset 사용
const user = await UserModel.findById(1, ["P"]);
// - 타입 안전
// - 코드 재사용
// - 유지보수 쉬움

// ⚠️ Raw Puri (특수한 경우만)
const user = await UserModel.getPuri("r")
  .table("users")
  .join("employees", "users.id", "employees.user_id")
  .leftJoin("departments", "employees.department_id", "departments.id")
  .select({
    id: "users.id",
    username: "users.username",
    deptName: "departments.name",
  })
  .where("users.id", 1)
  .first();
// - 타입 추론 복잡
// - 코드 중복
// - Subset으로 표현 안 되는 특수 쿼리만 사용