select

const users = await puri.table("users").selectAll();

// SELECT * FROM users

const users = await puri.table("users").select({
  id: "users.id",
  email: "users.email",
  name: "users.name"
});

// SELECT users.id, users.email, users.name FROM users

const users = await puri.table("users").select({
  userId: "users.id",
  userName: "users.name"
});

// SELECT users.id as userId, users.name as userName FROM users

const result = await puri.table("users")
  .select({
    total: Puri.count()  // COUNT(*)
  })
  .first();

console.log(result.total);  // number

// 특정 컬럼 카운트
const result = await puri.table("posts")
  .select({
    published: Puri.count("posts.published")
  })
  .first();

const stats = await puri.table("orders")
  .select({
    total: Puri.sum("orders.amount"),
    average: Puri.avg("orders.amount"),
    max: Puri.max("orders.amount"),
    min: Puri.min("orders.amount")
  })
  .first();

console.log(stats.total);    // number
console.log(stats.average);  // number

const users = await puri.table("users").select({
  id: "users.id",
  full_name: Puri.concat("users.first_name", "' '", "users.last_name"),
  email_upper: Puri.upper("users.email"),
  email_lower: Puri.lower("users.email")
});

const result = await puri.table("users").select({
  id: "users.id",
  
  // 문자열 반환
  display_name: Puri.rawString("CONCAT(users.first_name, ' ', users.last_name)"),
  
  // 숫자 반환
  age: Puri.rawNumber("YEAR(CURRENT_DATE) - YEAR(users.birth_date)"),
  
  // 불리언 반환
  is_adult: Puri.rawBoolean("YEAR(CURRENT_DATE) - YEAR(users.birth_date) >= 18"),
  
  // 날짜 반환
  signup_date: Puri.rawDate("DATE(users.created_at)"),
  
  // 문자열 배열 반환
  tags: Puri.rawStringArray("ARRAY_AGG(tags.name)")
});

// 타입이 자동으로 추론됨
result[0].display_name;  // string
result[0].age;           // number
result[0].is_adult;      // boolean
result[0].signup_date;   // Date
result[0].tags;          // string[]

const users = await puri.table("users")
  .leftJoin("posts", "users.id", "posts.user_id")
  .select({
    id: "users.id",
    email: "users.email",
    post: {
      id: "posts.id",
      title: "posts.title"
    }
  });

// 자동으로 flat하게 변환됨:
// SELECT 
//   users.id,
//   users.email,
//   posts.id as post__id,
//   posts.title as post__title
// FROM users LEFT JOIN posts ...

// 결과는 hydrate되어 중첩 객체로 반환
console.log(users[0].post.title);

let query = puri.table("users").select({
  id: "users.id",
  email: "users.email"
});

// 필드 추가
query = query.appendSelect({
  name: "users.name",
  created_at: "users.created_at"
});

// SELECT users.id, users.email, users.name, users.created_at FROM users

const posts = await puri.table("posts")
  .whereTsSearch("posts.content_tsv", "typescript")
  .select({
    id: "posts.id",
    title: Puri.tsHighlight("posts.title", "typescript"),
    content: Puri.tsHighlight("posts.content", "typescript", {
      startSel: "<mark>",
      stopSel: "</mark>",
      maxFragments: 3,
      maxWords: 50
    })
  });

const posts = await puri.table("posts")
  .whereTsSearch("posts.content_tsv", "typescript")
  .select({
    id: "posts.id",
    title: "posts.title",
    
    // 기본 rank
    rank: Puri.tsRank("posts.content_tsv", "typescript"),
    
    // 가중치 적용
    weighted_rank: Puri.tsRank("posts.content_tsv", "typescript", {
      weights: [0.1, 0.2, 0.4, 1.0],  // D, C, B, A 가중치
      normalization: 1  // 길이 정규화
    }),
    
    // Cover Density rank
    rank_cd: Puri.tsRankCd("posts.content_tsv", "typescript")
  })
  .orderBy("rank", "desc");

const posts = await puri.table("posts")
  .whereSearch("posts.title", "타입스크립트")
  .select({
    id: "posts.id",
    
    // 단일 컬럼 하이라이팅
    title: Puri.highlight("posts.title", "타입스크립트"),
    
    // 여러 검색어
    content: Puri.highlight("posts.content", ["타입스크립트", "자바스크립트"]),
    
    // 여러 컬럼 하이라이팅 (배열 반환)
    highlights: Puri.highlight(
      ["posts.title", "posts.content"],
      ["타입스크립트", "Node.js"]
    ),
    
    // 검색 점수
    score: Puri.score()
  })
  .orderBy("score", "desc");

// 타입 자동 추론
console.log(posts[0].title);       // string
console.log(posts[0].highlights);  // string[]
console.log(posts[0].score);       // number

const result = await puri.table("users")
  .select({
    id: "users.id",
    email: "users.email",
    count: Puri.count(),
    upper_name: Puri.upper("users.name")
  })
  .first();

// 타입 자동 추론
result.id;         // number
result.email;      // string
result.count;      // number
result.upper_name; // string

result.unknown;    // ❌ 타입 에러

// ❌ 나쁜 예: 이전 select가 덮어씌워짐
query.select({ id: "users.id" })
     .select({ name: "users.name" });  // id가 사라짐!

// ✅ 좋은 예: appendSelect로 추가
query.select({ id: "users.id" })
     .appendSelect({ name: "users.name" });

// ❌ 잘못됨
puri.table("users").select({
  id: "id"  // 어떤 테이블의 id인지 불명확
});

// ✅ 올바름
puri.table("users").select({
  id: "users.id"  // 명확한 테이블 지정
});

// Raw SQL 사용 시 반환 타입 명시
const result = await puri.table("users").select({
  // ✅ 타입 명시
  age: Puri.rawNumber("YEAR(CURRENT_DATE) - YEAR(birth_date)"),
  
  // ❌ 타입 없음 (any)
  unknown: puri.raw("SOME_COMPLEX_SQL")
});