Reqlivo 0.4.0 — resposta incremental no envio interativo
Estado: publicada em 2026-11-02 na tag v0.4.0. A release 0.4.0 contém instaladores Linux/Windows e SHA256SUMS. O workflow remoto passou em ubuntu-22.04 e windows-latest e publicou os assets listados abaixo. A validação manual no Windows, a instalação limpa e a auditoria com leitor de tela continuam pendentes; a publicação não altera essas lacunas.
Escopo entregue
- Resposta incremental no envio interativo da interface desktop. Os headers aparecem assim que a resposta HTTP começa e o corpo é renderizado em blocos durante a leitura, sem esperar o fim da transferência.
- Contador de bytes e estado visível. O painel mostra
recebendo, tamanho acumulado,content-type, redirecionamento e aviso de truncamento enquanto a resposta chega. - Prévia textual com UTF-8 preservado. Cada bloco é transportado em base64 e decodificado com
TextDecoderem modo de fluxo; caracteres divididos entre blocos não viram�. - Substituição pela resposta final. Ao concluir, a prévia parcial é descartada e o painel recebe a resposta bufferizada, com testes, logs, tempo, tamanho e hash calculados pelo mesmo caminho anterior.
- Cancelamento durante o recebimento. O envio continua cancelável depois do primeiro bloco, usando o ID de envio já existente.
- Truncamento consistente. Quando o corpo excede
max_response_bytes, a prévia para no limite e mostra o mesmo aviso da resposta final. - Fallback sem canal. Se a WebView não expõe
Channel, a interface usa o comando anterior e não exibe progresso; o harness headless e versões sem o novo IPC continuam funcionando.
O recurso vale para o botão Enviar da interface. O runner, a CLI, os relatórios, o histórico e o hash determinístico continuam usando a resposta completa e bufferizada.
Como funciona
- A interface cria um
tauri::ipc::Channele chamaapi_request_with_progress. - O Rust executa o mesmo
dispatchinterno, mas anexa umResponseProgressSinkà requisição em memória. - A rota
/api/sendlê essa extensão opcional e repassa o sink ao transporte. - O transporte emite
headersimediatamente e blocoschunkem lotes de até 64 KiB ou a cada 50 ms, o que ocorrer primeiro. - A interface decodifica os blocos e atualiza a prévia. A resposta final retornada pelo comando substitui o estado parcial.
Não há SSE, WebSocket, novo listener, servidor HTTP da interface ou chamada direta da WebView ao destino. O canal é uma extensão do IPC Tauri já existente. A resposta final continua sendo a única fonte para scripts, asserções, relatórios, histórico e hash.
Contratos adicionais
Os contratos anteriores foram preservados por wrappers aditivos:
| Item | Papel |
|---|---|
ResponseProgressEvent |
Enum com as variantes headers e chunk; os bytes do bloco usam base64. |
ResponseProgressSink |
Callback opcional e cloneable que recebe os eventos. |
transport::send_with_progress |
Variante de send com sink opcional. |
runner::execute_request_with_progress |
Variante de execute_request com sink opcional. |
runner::execute_single_with_progress |
Variante de execute_single com sink opcional. |
desktop::dispatch_with_progress |
Variante de dispatch que anexa o sink à requisição interna. |
api_request_with_progress |
Comando Tauri separado, porque Option<Channel<T>> não implementa CommandArg. |
send, execute_request, execute_single e dispatch continuam existindo e delegam para as variantes novas com None. A rota /api/send só emite progresso quando a extensão está presente; chamadas HTTP normais ao roteador em memória permanecem bufferizadas.
Compatibilidade
- O formato canônico continua OpenCollection 1.0.0; não há migração de schema, campo novo obrigatório ou alteração em
.reqlivo/. - A versão passa de
0.3.0para0.4.0emCargo.toml,src-tauri/Cargo.toml,src-tauri/tauri.conf.json,package.json,package-lock.jsone nas entradas dos pacotes próprios emCargo.lock. - A única dependência nova é
tokio-stream, restrita adev-dependenciespara os testes de transporte. - Coleções, rascunhos, lixeira, backups, importações e exportações da 0.3.0 continuam legíveis.
- A CLI e os contratos públicos do runner não mudam.
Publicação remota
- Tag anotada
v0.4.0no commit324af41(Implementa resposta incremental na 0.4.0). - Release publicada em 2026-11-02T01:40:48Z, não draft e não prerelease.
- Workflow Desktop e releases — run 41372772358 aprovado nos jobs
ubuntu-22.04ewindows-latest. - Push da
main: run 41372761841, também aprovado. - Release: v0.4.0.
| Asset | Bytes | SHA-256 |
|---|---|---|
Reqlivo_0.4.0_amd64.AppImage |
85.187.064 | 7898f785fb41fdb293f02a6a7f80f0a6518962a4610c3f7c6db5a636b7f1a026 |
Reqlivo_0.4.0_amd64.deb |
7.282.614 | debe9014527c508d99a7f05cdf362b3f5a91d08b48d8e87feda25f73b8bd38e2 |
Reqlivo_0.4.0_x64-setup.exe |
5.247.061 | 65011895d9ba22c3caec582359b4db32702cc6aeda73f69f85855926fed63c26 |
SHA256SUMS |
279 | — |
Os instaladores foram gerados e publicados pelo workflow, mas não foram instalados manualmente em máquinas limpas nesta versão.
Validação executada
Execução local em Linux x86_64, em 2026-11-01:
cargo fmt --all -- --checkpassou.cargo check --workspace --lockedpassou.cargo test --lockedpassou com 110 testes em 5 suítes.cargo test --workspace --lockedpassou com 110 testes em 6 suítes, incluindo a compilação do desktop.- Os testes novos cobrem ordem dos eventos, primeiro bloco antes da conclusão, UTF-8 dividido entre blocos, truncamento no limite e cancelamento após o primeiro bloco.
node --checkpassou parasrc/assets/app.js,scripts/ui-acceptance.mjsescripts/desktop-acceptance.mjs.python3 -m py_compilepassou para o servidor sintético escripts/check-version.pyconfirmou0.4.0.cargo build --release -p reqlivo-desktoppassou.git diff --checkpassou.- O harness de interface em Chrome headless passou 12/12 fluxos, incluindo o novo S-01, que renderiza headers e blocos, preserva UTF-8 dividido, mostra testes pendentes e substitui a prévia pela resposta final. Esse caso exercita o renderer no navegador; ele não substitui a validação do
Channelna WebView real. - O caso D-12 foi adicionado ao roteiro de desktop real, mas não foi executado: o ambiente não possui
WebKitWebDriverinstalado/localizado. Otauri-driverestá presente, porém sem o driver WebKit odesktop-acceptance.mjsnão inicia a sessão.
Evidências locais fora deste repositório: UI headless, capturas, checks e publicação.
Limitações restantes
- A visualização incremental não foi validada na WebView real nesta versão; D-12 permanece pendente por falta de
WebKitWebDriver. A matriz D-01 a D-11 da 0.3.0 não cobre o recurso novo. - O runner e a CLI não transmitem progresso visual; continuam retornando a resposta final. Upload multipart também não tem progresso.
- Corpos binários mostram apenas o indicador de recebimento durante o stream; a prévia base64 continua sendo montada a partir da resposta final.
- Os eventos são agrupados em até 64 KiB ou 50 ms. A cadência real depende do servidor, da rede e do tamanho dos blocos entregues pelo
reqwest. - A prévia parcial não executa scripts de pós-resposta, asserções ou testes; eles só rodam quando a resposta termina.
- A validação manual no Windows, a instalação limpa e a auditoria com leitor de tela não foram executadas. Os instaladores 0.4.0 foram gerados pelo workflow e publicados, mas não foram instalados manualmente em máquinas limpas.