🔐 AppGuardian (Mock-Compatible Version) #

This package provides a mock-compatible security monitoring system for Flutter applications.

It includes:

• ✅ A model to represent permission status
• 🔁 A testable interface (IPermissionService)
• 🧪 A mock implementation for reliable unit testing
• 📱 A real implementation using permission_handler (for production use)

📦 Installation #

Add to your pubspec.yaml:

dependencies:
  permission_handler: ^11.3.0
  app_guardian:
    path: ./app_guardian_mock # or your local path

🧠 How It Works #

Abstract Interface #

abstract class IPermissionService {
  Future<PermissionStatusReport> checkPermissions();
}

Real Service (uses permission_handler) #

final permissionService = RealPermissionService();
final status = await permissionService.checkPermissions();

Mock Service (for testing) #

final mockService = MockPermissionService();
final status = await mockService.checkPermissions();

✅ Sample Output #

PermissionStatusReport(
  camera: false,
  microphone: true,
  location: true,
  storage: false,
  contacts: true
)

🧪 Test Example #

test('Returns mock permission values correctly', () async {
  final mockService = MockPermissionService();
  final report = await mockService.checkPermissions();

  expect(report.camera, false);
  expect(report.microphone, true);
});

📌 License #

MIT © 2025 Mehmet Çelik