추출 계약의 요청 필드를 authorized 하나로 정리

[m-a-king]

Situation

• 계약이 headlessFirst(어느 플랫폼을 처음부터 브라우저로 보낼지)와 headlessAllowed(브라우저를 써도 되나) 두 필드를 받고 있었다. 앞은 최적화 힌트, 뒤는 계약이라 성격이 다른데 이름이 같은 계열이라 섞여 읽혔다.
• 불완전 승격이 들어온 뒤로 headlessFirst 는 정책 없이도 같은 결과에 도달해 값을 넣을 유인이 사라졌고, headlessAllowed 는 "브라우저를 여는 것 자체에 허락이 필요한가"라는 잘못된 전제를 담고 있었다.

Action

• 두 필드를 걷어내고 authorized 하나로 받는다: 이 대상이 플랫폼의 명시적 허락을 받았는가.
• 추출 경로는 이 값과 무관하게 같다는 것을 계약에 명시했다 — 정적 fetch 로 시작해 필요하면 브라우저로 승격하는 흐름은 항상 동일하고, authorized 가 여는 것은 렌더 서비스의 우회 수단(지문 보정·프록시)뿐이다.
• 브라우저를 여는 것 자체에는 허락이 필요 없다는 것도 명시했다. 신원을 UA 로 밝히고 우리 IP 로 가며 막히면 막힌 대로 보고하므로, 허락은 그 선을 넘을 때만 필요하다.
• 생략·null 은 false 로 정규화되는 fail-safe (구버전 호출자의 요청이 안전한 쪽으로만 어긋난다).

Result

• 이 계약을 구현하는 PR 셋이 함께 간다: renderer(TeamPiKi/renderer#22), extractor(요청 계약을 authorized 하나로 정리하고 헤드리스 게이트를 걷어낸다 extractor#46), core(플랫폼 정책을 허용·차단 한 축으로 교체 core#955).
• 배포 순서는 renderer → extractor → core 다. 각 단계가 새 필드를 모르면 무시하고 기존 동작을 하므로 중간 상태에서도 안전한 쪽(우회 없음)으로만 어긋난다.

---

연관 이슈

[coderabbitai]

Important

Review available on request

• 🔍 Trigger review

Reviews should be triggered manually for repositories with fewer than 10 stars. Select Trigger review above or comment @coderabbitai review to review the latest changes. For a full review, comment @coderabbitai full review.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 1b39428a-293c-4302-a0a8-884f88d86ae6

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}