02 — Repository API

// find — 0건이면 빈 배열
const users: User[] = await userRepo.find({ where: { active: true } });
 
// findOne — 0건이면 null
const user: User | null = await userRepo.findOne({ where: { id: 1 } });
 
// findOneBy — where만 받는 축약형
const user2 = await userRepo.findOneBy({ id: 1 });
 
// findOneOrFail — 0건이면 throw
try {
  const user = await userRepo.findOneOrFail({ where: { id: 1 } });
} catch (e) {
  // EntityNotFoundError
}
 
// findAndCount — 페이지네이션
const [list, total] = await userRepo.findAndCount({
  take: 20, skip: 0,
});
// list.length는 ≤ 20, total은 전체 매칭 수 (LIMIT 무시)

// save — upsert 의미
await userRepo.save(user);
// 1. user.id가 있으면 SELECT로 존재 확인 → 있으면 UPDATE, 없으면 INSERT
// 2. user.id가 없으면 바로 INSERT
// 3. cascade 관계도 같이 저장
// 4. @BeforeInsert/@BeforeUpdate 데코레이터 발화
 
// insert — 순수 INSERT
const result = await userRepo.insert({ name: "Alice" });
// result.identifiers = [{ id: 42 }]
// SELECT 없음, 빠르다. 하지만 user 인스턴스는 갱신되지 않는다.
 
// update — 순수 UPDATE
await userRepo.update({ id: 1 }, { name: "Bob" });
// UPDATE user SET name='Bob' WHERE id=1
// 다른 컬럼 건드리지 않음. dirty checking 없음.
 
// upsert — DB 네이티브
await userRepo.upsert(
  { email: "a@x.com", name: "A" },
  ['email']
);
// INSERT ... ON CONFLICT (email) DO UPDATE

// remove — hard delete, 인스턴스 받음
const user = await userRepo.findOneBy({ id: 1 });
await userRepo.remove(user);
// DELETE FROM user WHERE id = 1
// cascade·이벤트 동작, user.id는 undefined로
 
// delete — criteria 받음, 빠르다
await userRepo.delete(1);
await userRepo.delete({ active: false });
// DELETE FROM user WHERE ...
 
// softDelete — DeleteDateColumn 필요
@Entity()
class User {
  @DeleteDateColumn() deletedAt: Date | null;
}
 
await userRepo.softDelete(1);
// UPDATE user SET deletedAt = NOW() WHERE id = 1
 
await userRepo.restore(1);
// UPDATE user SET deletedAt = NULL WHERE id = 1

const post = new Post();
post.title = "Hello";
post.author = newUser;        // 새 user도 같이 저장될까?
 
await postRepo.insert(post);   // ✗ — user는 저장 안 됨, FK 에러
await postRepo.save(post);     // ✓ — cascade가 동작

const user = await userRepo.findOneBy({ id: 1 });
user.name = "Bob";
user.email = "bob@x.com";
 
// 이렇게 부르면 *어떤 컬럼이 바뀌었는지 모른다*
await userRepo.update({ id: 1 }, user);
// → 전체 컬럼이 SET되며 위험할 수 있음
 
// 안전한 방법
await userRepo.update({ id: 1 }, { name: "Bob", email: "bob@x.com" });
// 또는
await userRepo.save(user);     // upsert + SELECT

await userRepo.delete(1);
// posts 테이블의 author_id=1인 row가 자동 삭제될 거라고?
// ✗ — DB의 ON DELETE 옵션을 안 걸었으면 FK 에러
// ✓ TypeORM cascade를 쓰려면 remove(entity)

await userRepo.softDelete(1);
 
const u = await userRepo.findOneBy({ id: 1 });
// u === null — 안 보이지만,
 
const u2 = await userRepo.findOne({
  where: { id: 1 },
  withDeleted: true,
});
// u2 !== null — *DB에 그대로* 있다

// v0.2 — 가능
await userRepo.findOne(1);
 
// v0.3 — 컴파일 에러 또는 런타임 에러
await userRepo.findOne(1);          // ✗
await userRepo.findOneBy({ id: 1 }); // ✓
await userRepo.findOne({ where: { id: 1 } }); // ✓