fixture

pnpm fixture init

DUMP...
  ✓ Schema dumped from development_master

SYNC to (REMOTE) Fixture DB...
  ✓ Database myapp_fixture created
  ✓ Schema applied

SYNC to (LOCAL) Testing DB...
  ✓ Database myapp_test created
  ✓ Schema applied

Fixture initialization completed!

pnpm fixture import

? Please select entity: (Use arrow keys)
❯ User
  Post
  Comment

? Enter record IDs (comma-separated): 1,2,3

Importing fixtures...
  ✓ Imported User #1
  ✓ Imported User #2
  ✓ Imported User #3
  ✓ Imported related records (5 dependencies)

Fixture import completed!

pnpm fixture sync

Syncing fixtures...

Clearing test database...
  ✓ Cleared all tables

Applying fixtures...
  ✓ Applied 3 users
  ✓ Applied 7 posts
  ✓ Applied 12 comments
  ✓ Applied 5 categories

Fixture sync completed!

pnpm fixture gen

? Fixture를 생성할 Entity를 선택하세요: (Use arrow keys)
❯ ◯ User
  ◯ Post
  ◯ Comment

? 각 Entity별 생성 개수: 5

? User 엔티티가 포함되어 있습니다. 생성 방식을 선택하세요:
❯ 1. 로그인 가능한 사용자 fixture 생성
  2. 확인용 데이터(로그인 불가) 생성

? 저장 방식: (Use arrow keys)
❯ Fixture DB에 저장
  파일로 저장 (자동 파일명)
  파일로 저장 (파일명 지정)
  저장 안 함 (출력만)

? LLM으로 더 현실적인 데이터를 생성할까요? (fixtureHint 기반, ANTHROPIC_API_KEY 필요) No

로그인 가능한 사용자 5명 생성 중...
  ✅ alice@example.com 생성 완료
  ✅ bob@example.com 생성 완료
  ⚠️  carol@example.com 이미 존재 - 건너뜁니다.
  ✅ dave@example.com 생성 완료
  ✅ eve@example.com 생성 완료

email_verified = true 업데이트 완료

✅ 4명의 로그인 가능한 사용자 생성 완료

생성된 계정 목록:
┌─────────┬──────────────────────┬────────────┐
│ (index) │ email                │ password   │
├─────────┼──────────────────────┼────────────┤
│ 0       │ alice@example.com    │ Test1234!  │
│ 1       │ bob@example.com      │ Test1234!  │
│ 2       │ dave@example.com     │ Test1234!  │
│ 3       │ eve@example.com      │ Test1234!  │
└─────────┴──────────────────────┴────────────┘

# 예시: User, Post 각 10개씩 생성하여 DB에 저장
pnpm fixture gen --include User,Post --count 10 --save-to db

{
  "name": "id",
  "type": "string",
  "cone": {
    "fixtureStrategy": "sequence",
    "fixtureCompanions": [
      {
        "entity": "Account",
        "overrides": {
          "provider_id": "credential",
          "account_id": "{{email}}",
          "password": "{{email}}"
        }
      }
    ]
  }
}

pnpm sonamu auth add-companions

{
  "name": "id",
  "type": "integer",
  "cone": {
    "fixtureParentOverrides": {
      "achievement_type": "PAPER"
    }
  }
}

pnpm fixture fetch

? Import할 Entity를 선택하세요: (Use arrow keys)
❯ ◯ User
  ◯ Post
  ◯ Comment

User, Post import 중...
  ✓ User: 10개 import 완료
  ✓ Post: 10개 import 완료

# 예시: User의 최근 20개 데이터 가져오기
pnpm fixture fetch --include User --strategy recent --limit 20

pnpm fixture explore

? 탐색할 Entity: User

User 10개 조회 완료:
┌─────────┬────┬────────────────────┬──────────┐
│ (index) │ id │ email              │ name     │
├─────────┼────┼────────────────────┼──────────┤
│    0    │  1 │ 'user1@example.com'│ '홍길동' │
│    1    │  2 │ 'user2@example.com'│ '김철수' │
│   ...   │... │ ...                │ ...      │
└─────────┴────┴────────────────────┴──────────┘

# 예시: User 테이블에서 최근 5개 조회
pnpm fixture explore --include User --strategy recent --limit 5

# 테스트 DB 생성 및 스키마 복사
pnpm fixture init

# User #1, #2, #3 가져오기
pnpm fixture import

# Entity: User
# IDs: 1,2,3

pnpm test

pnpm fixture import

# Entity: Post
# IDs: 1

# 자동으로 포함됨:
# ✓ Post #1
# ✓ User #5 (author)
# ✓ Category #2 (category)

pnpm fixture import

# Entity: Post
# IDs: 1

# 자동으로 포함됨:
# ✓ Post #1
# ✓ post_tags (중간 테이블)
# ✓ Tag #1, #2, #3 (연결된 태그들)

describe("User CRUD", () => {
  beforeEach(async () => {
    // 각 테스트 전에 fixture 재적용
    await FixtureManager.sync();
  });

  test("사용자 생성", async () => {
    const user = await UserModel.create({
      email: "new@example.com",
      name: "신규사용자",
    });

    expect(user.id).toBeDefined();
  });

  test("사용자 삭제", async () => {
    await UserModel.deleteById(1);

    const user = await UserModel.findById(1);
    expect(user).toBeNull();
  });
});

import { Sonamu } from "sonamu";

test("트랜잭션 테스트", async () => {
  await Sonamu.runScript(async () => {
    // 트랜잭션 내에서 실행
    const user = await UserModel.create({...});
    const post = await PostModel.create({...});

    // 테스트 완료 후 자동 롤백
  });
});

describe("Post with Comments", () => {
  beforeAll(async () => {
    // Post #1 (+ User #1, Comments)
    await FixtureManager.sync();
  });

  test("댓글이 있는 Post 조회", async () => {
    const post = await PostModel.findById(1, {
      include: ["comments"],
    });

    expect(post.comments).toHaveLength(3);
    expect(post.comments[0].author_id).toBe(2);
  });
});

describe("Premium User Features", () => {
  beforeAll(async () => {
    // Premium user만 import
    await FixtureManager.importFixture("User", [10, 11, 12]);
    await FixtureManager.sync();
  });

  test("프리미엄 기능 접근", async () => {
    const user = await UserModel.findById(10);

    expect(user.isPremium).toBe(true);
    expect(await user.canAccessFeature("advanced")).toBe(true);
  });
});

Error: connect ECONNREFUSED

Error: Foreign key constraint violation

# 관련 데이터를 먼저 import
pnpm fixture import
# Entity: User
# IDs: 1,2,3

pnpm fixture import
# Entity: Post
# IDs: 1,2,3  # User 1,2,3을 참조

Error: Duplicate entry '1' for key 'PRIMARY'

# Test DB 초기화
pnpm fixture init

# Fixture 재동기화
pnpm fixture sync

# ❌ 모든 데이터 import
pnpm fixture import
# IDs: 1-1000

# ✅ 필요한 데이터만
pnpm fixture import
# IDs: 1,2,3  # 대표 케이스만

// ✅ 테스트 목적이 명확한 데이터
{
  "id": 1,
  "email": "admin@example.com",
  "role": "admin",
  "name": "관리자"
}
{
  "id": 2,
  "email": "user@example.com",
  "role": "user",
  "name": "일반사용자"
}

# Fixture 파일을 Git에 포함
git add src/fixtures/
git commit -m "Update test fixtures"