Claro, aqui está a documentação da biblioteca nano-wait-js formatada com Markdown para melhor legibilidade e estrutura.

NanoWait JS

NanoWait JS é uma biblioteca de espera adaptativa para Node.js, inspirada na versão Python. Ela substitui setTimeout fixo por esperas inteligentes baseadas na carga da CPU, perfis de execução, e pode incluir monitoramento de Wi-Fi.

Instalação

npm install nano-wait-js

Uso Básico

const { wait } = require('nano-wait-js');

(async () => {
    console.log("Início da espera adaptativa");
    await wait(2, { smart: true, verbose: true });
    console.log("Fim da espera!");
})();

CLI

Depois de instalar globalmente:

npm install -g nano-wait-js

Use o comando nano-wait no seu terminal:

nano-wait 3 --smart --profile ci

Opções da Função wait

• t (número): Tempo base de espera em segundos.
• smart (boolean): Ativa o cálculo adaptativo baseado na carga do sistema.
• verbose (boolean): Mostra informações detalhadas sobre a execução da espera.
• profile (string): Define o perfil de execução (ci, testing, rpa, default).
• explain (boolean): Retorna um relatório detalhado da espera em vez de aguardar.

Perfis de Execução

• ci: Ideal para pipelines e testes automatizados, onde o verbose é ativado por padrão para maior rastreabilidade.
• testing: Oferece um equilíbrio entre velocidade e estabilidade, adequado para a maioria dos cenários de teste.
• rpa: Perfil para automação de interfaces (RPA), com esperas mais conservadoras para garantir a estabilidade das interações.
• default: Comportamento padrão e equilibrado para uso geral.