abdalsalam_logic_flutter 0.1.0

Comprehensive Flutter logic package with modular app state management, networking, storage, auth, and 20+ reusable services following SOLID principles.

abdalsalam_logic_flutter

A comprehensive Flutter logic package providing 20+ reusable modules for app state management, networking, storage, authentication, and more. Built following SOLID principles with modular, opt-in architecture.

✨ Key Features

📱 Smart App State (21+ Domains)

• Real-time device monitoring (battery, connectivity, storage)
• Responsive breakpoint detection & platform awareness
• Modular architecture - only bundle what you enable

🌐 Networking & Storage

• Offline-first HTTP client with intelligent caching
• Unified storage gateway (SQLite + Hive + SharedPreferences)
• Automatic data synchronization and conflict resolution

🔐 Authentication & Security

• Firebase Auth integration with token management
• User isolation for all data operations
• Role-based permissions and access control

🎮 Runtime Control

• Native app restart functionality
• Custom domain registration system
• Dynamic UI tree management (refresh, rebuild, recreate)

🛠️ Developer Tools

• Structured logging with caller tracking
• Centralized error handling and classification
• Comprehensive file operations and sharing

📱 Platform Integration

• Calendar and contacts native access
• Firebase Cloud Messaging (FCM)
• Cross-platform utilities (Android, iOS, Web, Desktop)

🚀 Quick Start

Installation

Add to your pubspec.yaml:

dependencies:
  abdalsalam_logic_flutter: ^1.0.0

Run:

flutter pub get

💻 Usage

Quick Setup

import 'package:abdalsalam_logic_flutter/abdalsalam_logic_flutter.dart';

// Configure only the features you need (zero-impact bundling)
final config = AppStateConfig(
  enableConnectivity: true,
  enableDeviceInfo: true,
  enableBattery: true,
);

// Initialize and start using
final appStateManager = AppStateManagerImpl.create(
  LoggerServiceImpl(), 
  config: config,
);
await appStateManager.initialize();

Core Services

App State Management

// Reactive app state monitoring
StreamBuilder<AppStateInfo>(
  stream: appStateManager.stateStream,
  builder: (context, snapshot) {
    final state = snapshot.data;
    return state?.isOffline == true 
      ? OfflineBanner() 
      : YourMainWidget();
  },
);

Storage & Networking

// Unified storage access (SQLite + Hive + SharedPreferences)
await StorageGateway.instance.saveUser(user);
final userData = await StorageGateway.instance.getUser(userId);

// HTTP client with offline support
final apiClient = ApiClientImpl(logger);
final response = await apiClient.get('/api/data');

Authentication

final authService = AuthServiceImpl(logger, storage);
final result = await authService.signIn(email, password);

Advanced Features

Runtime Control

// Custom runtime domains
class MyFeatureDomain implements RuntimeDomain {
  @override
  String get domainId => 'my_feature';
  // Implementation...
}

// Native app restart
await AppControl.instance.restartApp();

Smart Optimizations

// Network-aware operations
appStateManager.stateStream.where((s) => s.isOnline).listen((_) => syncData());

// Battery-conscious background tasks
appStateManager.batteryStream
  .where((b) => !b.isLowBattery)
  .listen((_) => enableBackgroundSync());

// Responsive UI adaptation
final isLargeScreen = appStateManager.deviceInfo.breakpoint
  .index >= ResponsiveBreakpoint.lg.index;

📚 Documentation

Comprehensive guides and API documentation:

• 📖 Package Documentation - Complete usage guide
• 📱 App State Management - 21+ state domains
• 🔄 Runtime Control - Dynamic app control
• 🌐 Networking - HTTP client & offline support
• 💾 Storage System - Multi-layer storage gateway
• 🔐 Authentication - Firebase Auth integration
• 📝 Logging - Structured logging system
• ⚠️ Error Handling - Exception management
• 📁 File Operations - File system utilities
• 🔔 FCM Messaging - Push notifications
• 🚀 Prefetch System - Data preloading
• 🚀 Example App - Working demo

⚙️ Platform Support

Platform	Status
Android	✅ Full support
iOS	✅ Full support
Web	✅ Core features
macOS	✅ Core features
Windows	✅ Core features
Linux	✅ Core features

🔄 Migration

See CHANGELOG.md for version history and migration guides.

🤝 Contributing

Contributions are welcome! Please read the contributing guidelines first.

📜 License

MIT License - see LICENSE file for details.

📞 Support

• 🐛 Report Issues
• 💬 Discussions
• 📧 Email: [e-mail]