socket-page-automation

Socket Page Automation (`@socketsecurity/page-automation`) é uma biblioteca especializada projetada para lidar com automação de páginas de navegador e cadências de desafios anti-bot, particularmente para fluxos de verificação humana do npm. No seu núcleo, o projeto fornece uma máquina de estado sem dependências que gerencia de forma inteligente operações quando confrontada com interjeições dos sistemas de verificação humana do npm. Em vez de recorrer a tentativas cegas quando um desafio é detectado, o sistema pausa a operação por meio de uma costura assíncrona injetada. Essa costura permite que a lógica central permaneça completamente agnóstica em relação ao tempo de execução, o que significa que ela pode funcionar perfeitamente sob o Playwright, dentro de um script de conteúdo do navegador ou com um relógio de teste, sem nunca depender diretamente de um driver de navegador específico. Uma vez que um desafio é resolvido, o sistema rastreia o período de cooldown e permite que um lote de operações de acompanhamento aproveite a mesma janela de cooldown, reduzindo significativamente a necessidade de re-desafiar para cada operação individual. A biblioteca é estruturada com exportações de subcaminhos distintas para separar preocupações. A exportação raiz (`.`) contém a máquina de estado de cadência de desafio agnóstica em relação ao tempo de execução e suas constantes associadas. A exportação `./npm` fornece uma camada de conhecimento do site do npm sem dependências, que inclui seletores para opt-ins de cooldown, fatos de página e URL, e locators de stub para fluxos futuros de ação em lote e de editor confiável. O projeto está atualmente na versão 0.1.0, com costuras de implementação planejadas para um driver do Playwright (`./driver`) e uma implementação in-page de script de conteúdo (`./in-page`) a serem adicionadas assim que os consumidores forem estabelecidos.