armor

Releases

1. ▸▾1.0.012 Jul 2025

   🎉 Initial release of Armor package

   Added

   • 🎉 Initial release of Armor package
   • 🛡️ ArmorMixin for bulletproof widget protection
   • 🚫 Global error interception with ArmorInterceptor
   • 📊 Error tracking and statistics with ArmorRegistry
   • 🔧 Core protection methods:
     • safeExecute() - Execute code safely with fallbacks
     • safeSetState() - Prevent setState after dispose errors
     • safeAsync() - Safe async operations with mounted checks
     • safeBuild() - Build widgets with automatic fallback UI
   • 🖼️ armorImage() - Safe image loading with error handling
   • 🌐 armorNetworkRequest() - Network calls with retry logic
   • ⏱️ armorTimer() - Managed timers with automatic cleanup
   • 📡 armorStreamListen() - Protected stream subscriptions
   • 🔧 armorPlatformCall() - Safe platform method channel calls
   • 📁 armorFileOperation() - Protected file system operations
   • ⚡ armorPerformanceOperation() - Performance monitoring wrapper
   • 📈 Built-in statistics and monitoring
   • 🧹 Automatic resource cleanup on widget dispose
   • 🧪 Comprehensive test coverage
   • 📖 Complete documentation and examples
   • 🎯 Zero-configuration setup

   Features

   • Handles all major Flutter error types:
     • Null safety errors
     • setState after dispose
     • Render overflow (yellow/black stripes)
     • Image loading failures
     • Network timeouts and errors
     • Platform channel errors
     • File system errors
     • Memory leaks from undisposed resources
   • Intelligent caching system for continuity during failures
   • Performance monitoring with automatic warnings
   • Real-time error statistics and healing metrics
   • Stream-based error monitoring for analytics integration
   • Minimal performance overhead
   • Production-ready patterns and best practices

   Documentation

   • Comprehensive README with quick start guide
   • Complete API documentation
   • Real-world usage examples
   • Migration guide from manual error handling
   • Best practices and FAQ
   • Interactive example app demonstrating all features

   Testing

   • Unit tests for all core functionality
   • Widget tests for mixin behavior
   • Integration tests for error scenarios
   • Performance benchmarks
   • 100% analyzer compliance

   ---

   For more information, see the README and API documentation.