flet-android-notifications 0.1.0__tar.gz

flet_android_notifications-0.1.0/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: flet-android-notifications
+Version: 0.1.0
+Summary: Native local notifications for Flet apps (Android)
+Author-email: Alex Stoica <alexstoica@protonmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/alex-stoica/flet-android-notifications
+Project-URL: Repository, https://github.com/alex-stoica/flet-android-notifications
+Project-URL: Issues, https://github.com/alex-stoica/flet-android-notifications/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: flet>=0.80.5
+
+See the [full documentation on GitHub](https://github.com/alex-stoica/flet-android-notifications).

flet_android_notifications-0.1.0/README.md

@@ -0,0 +1 @@
+See the [full documentation on GitHub](https://github.com/alex-stoica/flet-android-notifications).

flet_android_notifications-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[project]
+name = "flet-android-notifications"
+version = "0.1.0"
+description = "Native local notifications for Flet apps (Android)"
+requires-python = ">=3.10"
+readme = "README.md"
+license = "MIT"
+authors = [
+    {name = "Alex Stoica", email = "alexstoica@protonmail.com"},
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "flet>=0.80.5",
+]
+
+[project.urls]
+Homepage = "https://github.com/alex-stoica/flet-android-notifications"
+Repository = "https://github.com/alex-stoica/flet-android-notifications"
+Issues = "https://github.com/alex-stoica/flet-android-notifications/issues"
+
+[tool.setuptools.package-data]
+"flutter.flet_android_notifications" = ["**/*"]
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"

flet_android_notifications-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

flet_android_notifications-0.1.0/src/flet_android_notifications/__init__.py

@@ -0,0 +1 @@
+from .flet_android_notifications import FletAndroidNotifications, NotificationError

flet_android_notifications-0.1.0/src/flet_android_notifications/flet_android_notifications.py

@@ -0,0 +1,112 @@
+import json
+import flet as ft
+from typing import Optional
+
+
+class NotificationError(Exception):
+    """Raised when a notification operation fails on the native side."""
+
+    pass
+
+
+@ft.control("flet_android_notifications")
+class FletAndroidNotifications(ft.Service):
+    on_notification_tap: Optional[ft.ControlEventHandler["FletAndroidNotifications"]] = None
+
+    def _check_error(self, result):
+        """Check if Dart returned an error and raise if so."""
+        if isinstance(result, str) and result.startswith("error:"):
+            raise NotificationError(result[6:])
+        return result
+
+    async def show_notification(
+        self,
+        notification_id: int,
+        title: str,
+        body: str,
+        *,
+        payload: str = "",
+        actions: Optional[list[dict]] = None,
+        channel_id: str = "flet_notifications",
+        channel_name: str = "Flet Notifications",
+        channel_description: str = "Notifications from Flet app",
+        importance: str = "high",
+        play_sound: bool = True,
+        enable_vibration: bool = True,
+    ):
+        """Show an Android notification.
+
+        Args:
+            notification_id: Unique integer ID for this notification.
+            title: Notification title.
+            body: Notification body text.
+            payload: Arbitrary string returned in on_notification_tap event.
+            actions: List of action buttons shown on the notification. Each is
+                a dict with "id" and "title" keys, e.g.
+                [{"id": "approve", "title": "Approve"}, {"id": "deny", "title": "Deny"}].
+                The tapped action's id is returned as "action_id" in the
+                on_notification_tap event data (JSON string).
+            channel_id: Android notification channel ID.
+            channel_name: Human-readable channel name (shown in system settings).
+            channel_description: Channel description (shown in system settings).
+            importance: One of "none", "min", "low", "default", "high", "max".
+            play_sound: Whether to play the default notification sound.
+            enable_vibration: Whether to vibrate on notification.
+
+        Raises:
+            NotificationError: If the native side reports an error.
+        """
+        result = await self._invoke_method(
+            method_name="show_notification",
+            arguments={
+                "id": notification_id,
+                "title": title,
+                "body": body,
+                "payload": payload,
+                "actions": actions or [],
+                "channel_id": channel_id,
+                "channel_name": channel_name,
+                "channel_description": channel_description,
+                "importance": importance,
+                "play_sound": play_sound,
+                "enable_vibration": enable_vibration,
+            },
+        )
+        return self._check_error(result)
+
+    async def cancel(self, notification_id: int):
+        """Cancel a specific notification by ID.
+
+        Raises:
+            NotificationError: If the native side reports an error.
+        """
+        result = await self._invoke_method(
+            method_name="cancel",
+            arguments={"id": notification_id},
+        )
+        return self._check_error(result)
+
+    async def cancel_all(self):
+        """Cancel all active notifications.
+
+        Raises:
+            NotificationError: If the native side reports an error.
+        """
+        result = await self._invoke_method(
+            method_name="cancel_all",
+        )
+        return self._check_error(result)
+
+    async def request_permissions(self):
+        """Request notification permissions (required on Android 13+).
+
+        Returns:
+            "true" if granted, "false" if denied.
+
+        Raises:
+            NotificationError: If the native side reports an error.
+        """
+        result = await self._invoke_method(
+            method_name="request_permissions",
+        )
+        return self._check_error(result)

flet_android_notifications-0.1.0/src/flet_android_notifications.egg-info/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: flet-android-notifications
+Version: 0.1.0
+Summary: Native local notifications for Flet apps (Android)
+Author-email: Alex Stoica <alexstoica@protonmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/alex-stoica/flet-android-notifications
+Project-URL: Repository, https://github.com/alex-stoica/flet-android-notifications
+Project-URL: Issues, https://github.com/alex-stoica/flet-android-notifications/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: flet>=0.80.5
+
+See the [full documentation on GitHub](https://github.com/alex-stoica/flet-android-notifications).

flet_android_notifications-0.1.0/src/flet_android_notifications.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+src/flet_android_notifications/__init__.py
+src/flet_android_notifications/flet_android_notifications.py
+src/flet_android_notifications.egg-info/PKG-INFO
+src/flet_android_notifications.egg-info/SOURCES.txt
+src/flet_android_notifications.egg-info/dependency_links.txt
+src/flet_android_notifications.egg-info/requires.txt
+src/flet_android_notifications.egg-info/top_level.txt
+src/flutter/flet_android_notifications/pubspec.yaml
+src/flutter/flet_android_notifications/lib/flet_android_notifications.dart
+src/flutter/flet_android_notifications/lib/src/extension.dart
+src/flutter/flet_android_notifications/lib/src/notifications_service.dart

flet_android_notifications-0.1.0/src/flet_android_notifications.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

flet_android_notifications-0.1.0/src/flet_android_notifications.egg-info/requires.txt

@@ -0,0 +1 @@
+flet>=0.80.5

flet_android_notifications-0.1.0/src/flet_android_notifications.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+flet_android_notifications
+flutter

flet_android_notifications-0.1.0/src/flutter/flet_android_notifications/lib/flet_android_notifications.dart

@@ -0,0 +1,3 @@
+library flet_android_notifications;
+
+export "src/extension.dart" show Extension;

flet_android_notifications-0.1.0/src/flutter/flet_android_notifications/lib/src/extension.dart

@@ -0,0 +1,15 @@
+import 'package:flet/flet.dart';
+
+import 'notifications_service.dart';
+
+class Extension extends FletExtension {
+  @override
+  FletService? createService(Control control) {
+    switch (control.type) {
+      case "flet_android_notifications":
+        return NotificationsService(control: control);
+      default:
+        return null;
+    }
+  }
+}

flet_android_notifications-0.1.0/src/flutter/flet_android_notifications/lib/src/notifications_service.dart

@@ -0,0 +1,185 @@
+import 'dart:async';
+import 'dart:convert';
+import 'package:flet/flet.dart';
+import 'package:flutter_local_notifications/flutter_local_notifications.dart';
+
+class NotificationsService extends FletService {
+  NotificationsService({required super.control});
+
+  final FlutterLocalNotificationsPlugin _plugin =
+      FlutterLocalNotificationsPlugin();
+  Completer<bool>? _initCompleter;
+  DateTime? _lastShowTime;
+
+  @override
+  void init() {
+    super.init();
+    control.addInvokeMethodListener(_onMethod);
+    _ensureInitialized();
+  }
+
+  @override
+  void dispose() {
+    control.removeInvokeMethodListener(_onMethod);
+    super.dispose();
+  }
+
+  Future<bool> _ensureInitialized() async {
+    if (_initCompleter != null) return _initCompleter!.future;
+    _initCompleter = Completer<bool>();
+
+    try {
+      const androidSettings =
+          AndroidInitializationSettings('@mipmap/ic_launcher');
+      const initSettings = InitializationSettings(android: androidSettings);
+
+      final result = await _plugin.initialize(
+        initSettings,
+        onDidReceiveNotificationResponse: (response) {
+          final hasAction = response.actionId != null && response.actionId!.isNotEmpty;
+          // Debounce only body taps — Samsung OneUI fires phantom body taps
+          // on show, but action button presses are always intentional.
+          if (!hasAction &&
+              _lastShowTime != null &&
+              DateTime.now().difference(_lastShowTime!).inSeconds < 3) {
+            return;
+          }
+          control.triggerEvent("notification_tap", jsonEncode({
+            "payload": response.payload ?? "",
+            "action_id": response.actionId ?? "",
+          }));
+        },
+      );
+      _initCompleter!.complete(result ?? false);
+    } catch (e) {
+      _initCompleter!.complete(false);
+    }
+
+    return _initCompleter!.future;
+  }
+
+  Importance _parseImportance(String value) {
+    switch (value) {
+      case "none":
+        return Importance.none;
+      case "min":
+        return Importance.min;
+      case "low":
+        return Importance.low;
+      case "default":
+        return Importance.defaultImportance;
+      case "high":
+        return Importance.high;
+      case "max":
+        return Importance.max;
+      default:
+        return Importance.high;
+    }
+  }
+
+  Priority _priorityFromImportance(Importance importance) {
+    switch (importance) {
+      case Importance.none:
+      case Importance.min:
+        return Priority.min;
+      case Importance.low:
+        return Priority.low;
+      case Importance.defaultImportance:
+        return Priority.defaultPriority;
+      case Importance.high:
+        return Priority.high;
+      case Importance.max:
+        return Priority.max;
+      default:
+        return Priority.defaultPriority;
+    }
+  }
+
+  Future<dynamic> _onMethod(String name, dynamic args) async {
+    try {
+      switch (name) {
+        case "show_notification":
+          final a = Map<String, dynamic>.from(args as Map);
+          final importance = _parseImportance(a["importance"] as String);
+          await _showNotification(
+            a["id"] as int,
+            a["title"] as String,
+            a["body"] as String,
+            payload: a["payload"] as String,
+            channelId: a["channel_id"] as String,
+            channelName: a["channel_name"] as String,
+            channelDescription: a["channel_description"] as String,
+            importance: importance,
+            priority: _priorityFromImportance(importance),
+            playSound: a["play_sound"] as bool,
+            enableVibration: a["enable_vibration"] as bool,
+            actions: (a["actions"] as List<dynamic>)
+                .map((action) => AndroidNotificationAction(
+                      action["id"] as String,
+                      action["title"] as String,
+                      cancelNotification: true,
+                      showsUserInterface: true,
+                    ))
+                .toList(),
+          );
+          return "ok";
+        case "cancel":
+          final a = Map<String, dynamic>.from(args as Map);
+          await _plugin.cancel(a["id"] as int);
+          return "ok";
+        case "cancel_all":
+          await _plugin.cancelAll();
+          return "ok";
+        case "request_permissions":
+          final granted = await _requestPermissions();
+          return granted.toString();
+      }
+      return null;
+    } catch (e) {
+      return "error:$e";
+    }
+  }
+
+  Future<void> _showNotification(
+    int id,
+    String title,
+    String body, {
+    required String payload,
+    required String channelId,
+    required String channelName,
+    required String channelDescription,
+    required Importance importance,
+    required Priority priority,
+    required bool playSound,
+    required bool enableVibration,
+    required List<AndroidNotificationAction> actions,
+  }) async {
+    await _ensureInitialized();
+    _lastShowTime = DateTime.now();
+
+    final androidDetails = AndroidNotificationDetails(
+      channelId,
+      channelName,
+      channelDescription: channelDescription,
+      importance: importance,
+      priority: priority,
+      playSound: playSound,
+      enableVibration: enableVibration,
+      actions: actions,
+    );
+    final details = NotificationDetails(android: androidDetails);
+
+    await _plugin.show(id, title, body, details, payload: payload);
+  }
+
+  Future<bool> _requestPermissions() async {
+    await _ensureInitialized();
+
+    final android = _plugin.resolvePlatformSpecificImplementation<
+        AndroidFlutterLocalNotificationsPlugin>();
+    if (android == null) return false;
+
+    final granted = await android.requestNotificationsPermission();
+    return granted ?? false;
+  }
+}

flet_android_notifications-0.1.0/src/flutter/flet_android_notifications/pubspec.yaml

@@ -0,0 +1,19 @@
+name: flet_android_notifications
+description: Local notifications for Flet
+version: 0.1.0
+publish_to: none
+
+environment:
+  sdk: '>=3.3.0 <4.0.0'
+  flutter: ">=1.17.0"
+
+dependencies:
+  flet: ^0.80.2
+  flutter:
+    sdk: flutter
+  flutter_local_notifications: ^19.0.0
+
+dev_dependencies:
+  flutter_test:
+    sdk: flutter
+  flutter_lints: ^3.0.0