flog_flow 0.4.0

Graba el flujo de navegación real del usuario (pantallas, taps, red, logs y errores) y lo exporta en un archivo cifrado .flowx que se reproduce en un visor web.

Changelog

0.4.0

Correcciones de integración a partir del feedback de los primeros usuarios.

• Varios Navigators: nuevo FlogFlow.instance.newNavigatorObserver() — crea un observer por cada Navigator (GetMaterialApp + MaterialApp anidado, Navigators propios). Reutilizar navigatorObserver en dos Navigators dispara un assert del framework difícil de rastrear; ahora está documentado y tiene salida.
• FlogCloud.start ya no bloquea el arranque: la grabación se arma primero (barato) y las subidas pendientes se drenan en segundo plano. Antes, una subida lenta o sin red retrasaba el primer frame y se perdía el inicio de la sesión. awaitPendingUploads: true recupera el comportamiento anterior.
• Timeouts en todas las subidas (FlogCloud, FlogHttpUpload, FlogLogs): connect 15 s / send 1–2 min / receive 30 s. Sin ellos, una red móvil intermitente colgaba la petición indefinidamente.
• Los fallos de subida ya no son silenciosos: debugPrint con el status en debug y hooks opcionales FlogCloud.onUploadError / FlogHttpUpload(onError:) para distinguir 401 (token), 402 (cuota), 413 (tamaño) o caída de red.
• Aviso al montar dos FlogFlogScope: cada scope pisa al anterior y los screenshots salen del RepaintBoundary equivocado sin ningún error; ahora se avisa fuerte en consola (debug). El scope además se desregistra al desmontarse.
• Aviso de eventos previos a start() (debug, una sola vez): antes se descartaban en silencio y la sesión salía vacía sin pista alguna.
• FlogCloud.start acepta initialRouteName: la grabación arranca después del primer frame, así que el didPush inicial ya pasó; sin esto la primera pantalla salía sin nombre.
• FlogFlow.instance.screenNameResolver: hook para nombrar rutas anónimas (MaterialPageRoute/PageRouteBuilder sin settings.name), p. ej. por runtimeType.
• archive acepta 3.x y 4.x (>=3.3.0 <5.0.0): el rango estrecho ^4.0.2 chocaba con apps que fijan archive ^3.x e impedía instalar el paquete.

0.1.0

Versión inicial.

• Grabación de pantallas (screenshots JPEG de baja calidad), taps, scrolls y navegaciones (FlogFlow + FlogFlowScope + observer de navegación).
• Captura opcional de red (FlogDioInterceptor), logs (FlogLogCapture) y errores con stack trace y screenshot.
• Breadcrumbs, metadata de sesión y línea de tiempo unificada.
• Redacción de datos sensibles en screenshots (RedactedZone).
• Export siempre cifrado en contenedor .flowx (PBKDF2 + AES-256-GCM, empaquetado en isolate).
• Visor web autocontenido (viewer/viewer.html).
• Subida automática a la plataforma FlogFlow (FlogCloud) con recuperación de subidas pendientes.
• Borrado automático de datos (cleanupOnStart, deleteAfterExport) y modo grabar-solo-si-hay-error.