무엇이 바뀌었나

이제 클라이언트 키는 30개 이상 리전의 Shoal 엣지 네트워크에서 평가됩니다. 브라우저와 모바일 SDK가 규칙을 내려받지 않고도 약 10ms 안에 결과를 받습니다.

• 신규: POST /v2/evaluate가 클라이언트 키를 받고 결과값만 돌려줍니다. 평가를 참고하세요.
• 신규: rollout.step, rollout.guard_triggered 웹훅.
• 개선: 자바스크립트 SDK 크기가 18% 줄었습니다(gzip 4.1kB).

출시에 지표를 연결하면 기준을 넘을 때 Shoal이 자동으로 멈추거나 되돌립니다. 점진적 출시 가이드를 읽어 보세요.

guard:
  metric: checkout_error_rate
  max: 0.02
  action: rollback

• 수정: 일부 사내 프록시 뒤의 SDK가 60분 뒤 업데이트를 받지 못하던 문제. 이제 무작위 간격을 둔 백오프로 다시 연결합니다.
• 수정: Windows 줄바꿈에서 shoal generate --check가 차이를 잘못 보고하던 문제.

• 신규: 재사용하는 세그먼트. “베타 테스터”를 한 번 정의하면 어느 플래그에서든 쓸 수 있습니다.
• 신규: 앱 버전용 semver_gte, semver_lt, semver_eq 연산자.
• 개선: 규칙 편집기에 지난 24시간 동안 규칙별로 일치한 사용자 수가 표시됩니다.

이제 웹훅 요청은 Shoal-Signature 헤더에 HMAC-SHA256 서명이 붙습니다.

• 보안: 페이로드를 믿기 전에 서명을 검증하세요. 서명 검증을 참고하세요.
• 호환성 변경: 예전 X-Shoal-Token 헤더가 없어졌습니다. 이 헤더에 의존하던 엔드포인트는 서명 검증으로 바꿔야 합니다.

타입 있는 플래그, 로컬 평가, 규칙 기반 타기팅을 갖춘 새 SDK입니다.

• 신규: 의존성 없는 @shoal/sdk, ESM + CJS, 엣지 지원.
• 신규: 타입 안전한 플래그 키를 위한 shoal generate.
• 호환성 변경: 패키지 이름이 shoal-js에서 바뀌고 메서드 이름도 바뀌었습니다. 마이그레이션 가이드를 따라 하세요.