flutter_mayday 0.2.0

On-device crash reporting for Flutter. Captures device, session, network, logs, errors, and performance into a single shareable .blackbox file — no server, no account, no dashboard required.

0.2.0

• Package renamed from black_box to flutter_black_box. Import path is now package:flutter_black_box/flutter_black_box.dart.

• BlackBox.setNavigatorKey() — new API to register a GlobalKey<NavigatorState> so the overlay can push BlackBoxViewerScreen from above MaterialApp (shake and badge tap).

• android/build.gradle and ios/flutter_black_box.podspec — build files added; the plugin was previously missing Gradle and CocoaPods configuration.

• BlackBoxOnCrash now fires correctly. Fatal errors recorded by ErrorCollector trigger export() and optionally share() according to the configured onCrash value. Previously the enum had no effect.

• Export timeout. BlackBox.export() now times out after 30 seconds and throws TimeoutException if a state adapter serialiser hangs, preventing indefinite UI freezes.

• Screenshot on crash. When screenshotOnCrash: true, BlackBoxScope captures a PNG via RepaintBoundary at crash time and embeds it as screenshot_png_b64 in the report.

• Shake-to-report. BlackBoxOverlay now uses sensors_plus to listen for real shake gestures when shakeToReport: true. Long-press on the badge still works as a fallback.

• ReportFormat.json. New export format writes pretty-printed JSON directly — opens in any text editor without a special viewer.

• BlackBoxMode.off. New mode fully disables all collection. All recording methods become no-ops; export/capture/share throw StateError. Use for enterprise telemetry opt-out.

• Fixed double deviceCollector.collect(). ReportBuilder._environment() now caches the device snapshot instead of calling collect() twice per export.

• pub.dev metadata. Added repository, issue_tracker, and topics to pubspec.yaml.

0.1.0

• Initial BlackBox package implementation.
• Added bounded collectors for app, device, errors, navigation, Dio network traffic, logs, frame timings, and verbose gestures.
• Added .blackbox binary envelope encoder/decoder with gzip and CRC32 verification.
• Added recursive PII sanitizer with key blocklist, regex, JWT, and credit-card rules.
• Added BLoC and GetX state adapters, root scope, overlay, native method channels, example app, and tests.