airo_notifications #

Native-first local alert, notification grouping, task follow-up & scheduling execution engine for Flutter.

Overview #

airo_notifications acts as the execution layer between local AI engines (Aromind) or app features and native OS notification systems. Rather than exposing basic platform APIs, it provides semantic alert models (notification, reminder, alert, task), notification grouping/summarization strategies (stack, summary, replace, merge), persistent schedule query stores, and task action routing (complete, snooze, dismiss, open).

Features #

• Semantic Alert Types: Distinction between Notifications, Reminders, Alerts, and Tasks.
• Timezone-Aware Scheduling: Persistent scheduled alert store surviving reboots.
• Grouping Strategies: stack, summary, replace, and merge rules.
• Task Action Routing: Built-in complete, snooze, dismiss, and open callback stream.
• Deterministic Test Harness: FakeAiroNotificationEngine for unit testing without native device dependencies.

Usage #

import 'package:airo_notifications/airo_notifications.dart';

final alert = AiroAlert(
  id: 'followup_123',
  type: AiroAlertType.task,
  delivery: AiroDeliveryMode.scheduled,
  priority: AiroPriority.high,
  title: 'Follow up with Rahul',
  body: 'Deployment discussion',
  scheduledAt: DateTime.now().add(const Duration(hours: 12)),
  taskId: 'task_456',
  source: 'aromind',
);

await AiroNotifications.engine.schedule(alert);