Contract Testing계약 테스팅

1. Consumer(소비자)가 기대 인터랙션을 Pact 파일에 기록
   POST /users { name: "Alice" } → 201 { id: 1, name: "Alice" }

2. Consumer 테스트 실행 → pact/consumer-provider.json 생성

3. Pact Broker에 계약 파일 게시

4. Provider(제공자)가 Pact Broker에서 계약 가져와 검증
   실제 서비스 기동 후 계약 재생 → 응답 비교

5. 불일치 시 빌드 실패 → 즉각 피드백

import { Pact } from '@pact-foundation/pact';
import { like, term } from '@pact-foundation/pact/src/dsl/matchers';

const provider = new Pact({
  consumer: 'UserApp',
  provider: 'UserService',
  port: 1234,
});

describe('User API Contract', () => {
  before(() => provider.setup());
  after(() => provider.finalize());

  it('gets user by id', async () => {
    await provider.addInteraction({
      state: 'user 1 exists',
      uponReceiving: 'GET /users/1',
      withRequest: { method: 'GET', path: '/users/1' },
      willRespondWith: {
        status: 200,
        body: {
          id: like(1),
          name: like('Alice'),
          email: term({ generate: 'alice@example.com', matcher: '.+@.+' }),
        },
      },
    });

    const user = await fetchUser(1); // 실제 클라이언트 코드
    expect(user.id).toBe(1);
  });
});

역할:
- 계약 파일 중앙 저장소
- can-i-deploy: 배포 안전성 확인
- 계약 버전 관리
- 웹 UI로 의존 관계 시각화

PactFlow (SaaS): 엔터프라이즈 기능 포함