socket-page-automation

Socket Page Automation (`@socketsecurity/page-automation`) es una biblioteca especializada para el manejo de la automatización de páginas web y las cadencias de desafíos anti-bot, particularmente en flujos de verificación humana de npm. En su núcleo, proporciona una máquina de estado sin dependencias que gestiona de manera inteligente las operaciones cuando se encuentran con interrupciones del sistema de verificación humana de npm. En lugar de recurrir a reintentos ciegos cuando se detecta un desafío, el sistema pausa la operación a través de una costura asíncrona inyectada. Esta costura permite que la lógica central siga siendo completamente agnóstica al entorno de ejecución, funcionando sin problemas con Playwright, dentro de un script de contenido del navegador o con un reloj de prueba, sin depender directamente de un controlador de navegador específico. Una vez que se resuelve el desafío, el sistema rastrea el período de enfriamiento y permite que un lote de operaciones de seguimiento aproveche la misma ventana de enfriamiento, reduciendo significativamente la necesidad de volver a desafiar por cada operación individual. La biblioteca está estructurada con exportaciones de subrutas distintas para separar las preocupaciones. La exportación raíz (`.`) contiene la máquina de estado de cadencia de desafío agnóstica al entorno de ejecución y sus constantes asociadas. La exportación `./npm` proporciona una capa de conocimiento del sitio de npm sin dependencias, que incluye selectores para la opción de enfriamiento, hechos de página y URL, y locators de stub para flujos futuros de acción masiva y de editor de confianza. El proyecto se encuentra actualmente en la versión 0.1.0, con planes para implementar costuras para un controlador de Playwright (`./driver`) y una implementación de script de contenido en la página (`./in-page`) una vez que los consumidores estén establecidos.