firebase_analytics_monitor 1.1.0

A command-line tool to monitor Firebase Analytics events from logcat.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.1.0 - 2026-01-13

Security

• Added input validation for custom parameters and frequency options
• Added file path validation to prevent path traversal attacks
• Added explicit null handling for stdin.readLineSync()
• Added safe type casting for argResults in DatabaseCommand
• Added validation to DateTimeRange constructor

Changed

• Replaced overly broad exception handling with specific types
• Extracted MonitorCommand.run() into smaller focused methods
• Consolidated event filtering logic in EventFilterUtils
• Introduced FilteredMonitorDependencies container for better DI
• Extracted FaWarningBuffer from EventFormatterService (SRP)
• Extracted DatabaseDirectoryResolver from IsarDatabase
• Replaced hardcoded magic numbers with named constants
• Used consistent DI for UpdateCommand
• Optimized log parser regex evaluation order
• Pushed event filtering to database level for better performance
• Optimized list creation in EventCacheService

Added

• Warning for malformed UTF-8 data in logcat output
• Visible warnings for parameter parsing failures
• Comprehensive tests for FilteredMonitorCommand

Fixed

• Corrected branch name in static analysis workflow
• Increased minimum test coverage threshold to 30%

1.0.2 - 2026-01-12

Fixed

• Fixed package installation from pub.dev by including generated files (*.g.dart, *.config.dart)
• Package can now be properly installed via dart pub global activate firebase_analytics_monitor

1.0.1 - 2025-12-19

Changed

• Replaced specific event examples with generic event names in documentation
• Improved example output in README to be more generic

Added

• MIT LICENSE file
• CHANGELOG.md following Keep a Changelog format
• GitHub Actions workflow for static analysis on PRs to dev branch

1.0.0 - 2025-12-19

Added

• Real-time Firebase Analytics event monitoring via adb logcat
• Smart filtering with --hide and --show-only options
• Beautiful colorized output for events
• Session statistics and smart suggestions for filtering
• Event parsing with support for parameters and item arrays
• famon monitor command for real-time event streaming
• famon help command with detailed usage examples
• Shell completion support
• Persistent event storage with Isar database
• Export/import functionality for event data