socket-page-automation

Socket Page Automation (`@socketsecurity/page-automation`)은 브라우저 페이지 자동화와 안티봇 챌린지 캐던스를 처리하기 위해 설계된 전문 라이브러리로, 특히 npm 스타일의 인간 검증 흐름에 적합합니다. 이 프로젝트의 핵심은 npm의 인간 검증 시스템에서 챌린지가 발생했을 때 작업을 지능적으로 관리하는 의존성 없는 상태 머신입니다. 챌린지를 감지했을 때 무작정 재시도하는 대신, 시스템은 주입된 비동기 심을 통해 작업을 일시 중단합니다. 이 심은 런타임에 독립적인 방식으로 작동하므로, Playwright, 브라우저 콘텐츠 스크립트, 또는 테스트 클록 등 다양한 환경에서 특정 브라우저 드라이버에 의존하지 않고도 원활하게 작동합니다. 챌린지가 해결되면 시스템은 쿨다운 기간을 추적하고, 같은 쿨다운 창 내에서 후속 작업을 배치로 처리할 수 있게 하여 개별 작업마다 챌린지를 다시 시도해야 하는 필요성을 크게 줄입니다. 라이브러리는 관심사를 분리하기 위해 별도의 서브패스 내보내기로 구성되어 있습니다. 루트 내보내기 (`.`)에는 런타임 독립적인 챌린지 캐던스 상태 머신과 관련 상수들이 포함되어 있습니다. `./npm` 내보내기는 쿨다운 옵트인, 페이지 및 URL 정보, 그리고 향후 벌크 액션 및 신뢰할 수 있는 발행자 흐름을 위한 스텁 로케이터를 포함하는 의존성 없는 npm 사이트 지식 레이어를 제공합니다. 현재 버전은 0.1.0이며, 향후 Playwright 드라이버 (`./driver`)와 콘텐츠 스크립트 인페이지 구현 (`./in-page`)을 위한 구현 심이 추가될 예정입니다.