প্রকল্প সম্পর্কে

Socket Page Automation (`@socketsecurity/page-automation`) is a specialized library designed to handle browser page automation and anti-bot challenge cadences, particularly for npm-style human-verification flows. At its core, the project provides a dependency-free state machine that intelligently manages operations when faced with interjections from npm's human-verification systems. Instead of resorting to blind-retries when a challenge is detected, the system pauses the operation through an injected async seam. This seam allows the core logic to remain completely runtime-agnostic, meaning it can function seamlessly under Playwright, within a browser content script, or with a test clock, without ever directly depending on a specific browser driver. Once a challenge is solved, the system tracks the cooldown period and allows a batch of follow-up operations to ride the same cooldown window, significantly reducing the need to re-challenge for every individual operation. The library is structured with distinct subpath exports to separate concerns. The root export (`.`) contains the runtime-agnostic challenge-cadence state machine and its associated constants. The `./npm` export provides a dependency-free npm site-knowledge layer, which includes selectors for cooldown opt-ins, page and URL facts, and stub locators for future bulk-action and trusted-publisher flows. The project is currently at version 0.1.0, with planned implementation seams for a Playwright driver (`./driver`) and a content-script in-page implementation (`./in-page`) to be added once consumers are established.