flutter_telescope 1.2.0

A powerful Flutter package for network activity monitoring and debugging with beautiful UI and comprehensive logging.

Changelog

All notable changes to flutter_telescope package will be documented in this file.

1.2.0 - 2026-07-07

Fixed

• Lost logs under concurrency - activities no longer use a millisecond timestamp as their primary key with ConflictAlgorithm.replace. Records are now inserted with a null id so SQLite AUTOINCREMENT assigns a unique key, eliminating same-millisecond collisions and silent overwrites.
• Double navigation from the floating button (both the outer GestureDetector and inner InkWell fired), which could push the inspector page twice.
• DioInterceptor API - removed required networkInspector parameter (now uses static NetworkInspector class directly)
• Dio duration tracking - added startTime tracking directly in DioInterceptor's onRequest (works both with DioClientHelper and when adding interceptor to existing Dio instances)

Added

• Sensitive-data redaction: Authorization, Cookie, Set-Cookie, X-Api-Key and similar headers are masked before storage by default. Configurable via NetworkInspectorConfig.configureRedaction(), addSensitiveHeader() and removeSensitiveHeader().
• Release-build guard: capture is disabled in release builds by default. Opt in with NetworkInspectorConfig.setCaptureInReleaseMode(true).
• Non-blocking batched writes: logActivity() now buffers and flushes activities in batches off the request path, removing per-request DB latency. Added NetworkInspector.flush() to force a write.
• Pagination: getActivities({int? limit, int? offset}).
• Retention row cap: NetworkInspectorConfig.setMaxStoredActivities() trims the oldest rows (default 1000) in addition to time-based cleanup.
• Real http.Client: new TelescopeHttpClient extends http.BaseClient is a genuine drop-in client supporting all methods, streamed responses and multipart uploads.
• Better multipart logging: Dio FormData and http MultipartRequest bodies are now summarized as readable field/file metadata instead of toString().

Improved

• Floating button gracefully falls back to the nearest Navigator when NavigationService.navigatorKey is not attached to MaterialApp.
• Ease of use - simplified Dio and HTTP client setup (no need to pass NetworkInspector instance anymore)
• Documentation - updated README with examples of adding DioInterceptor directly to existing Dio clients and using TelescopeHttpClient as a drop-in replacement

1.1.0 - 2026-03-13

Added

• Automatic cleanup functionality for old network activities
• Configurable cleanup interval with default 10-minute setting
• Manual cleanup API with NetworkInspector.cleanupOldActivities()
• Cleanup configuration methods in NetworkInspectorConfig:
  • configureAutoCleanup() - Enable/disable and set interval
  • enableAutoCleanup() - Enable with custom interval
  • disableAutoCleanup() - Disable automatic cleanup
  • setCleanupInterval() - Update cleanup interval
• Timer-based automatic cleanup that starts on initialization
• Safe cleanup handling with proper error management
• Cleanup test page in example app for testing functionality
• Enhanced documentation with cleanup usage examples

Improved

• Database management with automatic old data removal
• Memory usage optimization through periodic cleanup
• Configuration flexibility for different app requirements
• Example app with cleanup testing capabilities
• Package documentation updated with new features

Fixed

• Timer lifecycle management - proper cleanup on database close
• Configuration state management for cleanup settings
• Error handling in automatic cleanup operations

1.0.9 - 2026-01-29

Fixed

• Search field theme issues - resolved white-on-white text visibility problem
• Text color contrast in both Network Inspector and API Inspector search fields
• Hint text visibility with proper alpha transparency in both light and dark themes
• Icon color theming for search and clear icons to match app theme
• Theme consistency - search fields now properly use scheme.onSurface colors

Improved

• Light theme support - dark text on light backgrounds with proper contrast
• Dark theme support - light text on dark backgrounds with proper contrast
• Accessibility - better text visibility for users in both theme modes
• Theme integration - search fields now follow Material 3 color scheme guidelines

1.0.8 - 2026-01-29

Added

• Chrome-style floating search with toggle functionality in Network Inspector and API Inspector
• Search result counting with "X of Y" display for easy navigation
• Text highlighting in API Inspector for found matches in headers and body content
• Navigation arrows (up/down) to move between search results
• Auto-focus management - search field automatically gets focus when opened
• Auto-hide behavior - search bar hides when focus is lost and field is empty

Improved

• Smaller, cleaner search bars positioned in top-right corner (300px width)
• Working navigation arrows that properly scroll to search results
• Simplified UI design with minimal shadows and cleaner borders
• Better space utilization - search doesn't interfere with content
• Smooth scrolling animations for navigation between results
• Enhanced user experience similar to modern web browsers

Fixed

• Navigation functionality - arrows now properly scroll to highlighted results
• Code quality issues - resolved all lint warnings and errors
• Duplicate method definitions and unused code
• Controller lifecycle management with proper final declarations
• Function literal usage replaced with proper for loops

1.0.7 - 2026-01-22

Fixed

• Improved demo UI with better visual presentation
• Fixed documentation issues and formatting
• Updated README with correct demo GIF
• Minor bug fixes and code cleanup
• Enhanced example app user experience

Added

• Better demo showcase with improved UI elements
• Updated documentation with proper examples
• Enhanced visual assets for README

1.0.6 - 2026-01-21

Fixed

• Improved dialog UI consistency across the application
• Enhanced clear confirmation dialog with better styling
• Reverted FilledButton to ElevatedButton for better compatibility
• Improved dialog builder context handling
• Better visual hierarchy in confirmation dialogs

Added

• Enhanced user experience with consistent dialog styling
• Improved button styling for better accessibility
• Better dialog interaction patterns

1.0.5 - 2026-01-21

Fixed

• Complete Material 3 theme integration for ActivityPage and ActivityDetailPage
• Enhanced color scheme usage with proper theme-aware colors
• Improved status indicators with theme-aware color selection
• Fixed loading indicator colors and empty state styling
• Better contrast and accessibility across light/dark themes
• Enhanced HTTP method badges with accent colors
• Improved time formatting with zero-padding

Added

• Dynamic theme-aware status colors based on ColorScheme
• Enhanced visual hierarchy with proper Material 3 tokens
• Better splash effects and interaction feedback
• Improved copy/share functionality in detail pages
• Enhanced error handling and status visualization
• Comprehensive theme support for all UI components

1.0.4 - 2026-01-21

Fixed

• Complete theme overhaul for ActivityPage and ActivityDetailPage
• Replaced all hardcoded colors with proper theme integration
• Improved text visibility in both light and dark modes
• Enhanced UI components with Material 3 design principles
• Fixed status indicators and color consistency
• Better contrast and accessibility across all themes

Added

• Full theme-aware color scheme implementation
• Dynamic theming for all UI components
• Proper Material 3 color usage throughout
• Enhanced visual hierarchy and component styling
• Improved empty states and loading indicators
• Better error handling and status visualization

1.0.3 - 2026-01-21

Fixed

• Fixed theme issues in ActivityPage and ActivityDetailPage
• Replaced hardcoded colors with proper theme colors
• ActivityPage now respects app theme (light/dark mode)
• ActivityDetailPage now uses theme-aware colors
• Fixed text visibility issues in both light and dark themes
• Improved shadow colors to work with any theme

1.0.2 - 2026-01-21

Fixed

• Improved documentation coverage to meet pub.dev requirements (20%+)
• Added comprehensive dartdoc comments to all major public APIs
• Fixed library declaration in main export file
• Enhanced package documentation with usage examples

Added

• Documentation for ActivityPage, ActivityDetailPage, and ActivityCard widgets
• Documentation for NavigationService and NetworkInspectorConfig classes
• Package-level documentation with feature overview and usage guide
• Method-level documentation for key public APIs

1.0.1 - 2026-01-21

Fixed

• Fixed deprecated printTime API usage in logger
• Updated to use dateTimeFormat with DateTimeFormat.onlyTimeAndSinceStart
• Improved documentation coverage for public API elements
• Fixed main library file naming to match package name
• Resolved example app import issues
• Enhanced example app UI with Material 3 design

Added

• Comprehensive dartdoc documentation for major classes
• Beautiful gradient header in example app
• Improved button styling with icons
• Better error handling and loading states
• Enhanced response display with monospace font

1.0.0+1 - 2026-01-20

Added

• Initial release of flutter_telescope network inspector
• Network activity monitoring and logging for Dio and HTTP clients
• Professional logging framework integration
• Beautiful, theme-aware UI for viewing network activities
• Request/response body formatting and display
• Comprehensive error tracking and debugging tools
• Floating test button for easy access to network inspector
• Copy and share functionality for network data
• Light and dark mode support
• JSON pretty-printing for request/response bodies
• Database storage and management for network activities
• Example app demonstrating all features
• GitHub repository integration for issue tracking and support