Clean up example app and release v1.0.0 (#15)

Filter FCM metadata from notification tap payloads, clean up example
app, and bump to v1.0.0 stable release.

Author: mlaucis

CHANGELOG.md

@@ -1,20 +1,3 @@
-## 1.0.0-dev.5
+## 1.0.0
 
-- Initial stable release of PNTA Flutter plugin.
-
-## 1.0.0-dev.4
-
-- Fix parameter signature mismatch in updateMetadata method
-- Remove unnecessary hex token conversion in iOS identify handler  
-- Fix Android memory leak in permission handler
-- Remove redundant notification channel creation
-- Add error handling for event stream casting errors
-- Add retry logic with exponential backoff for network requests
-- Standardize error codes across platforms (NO_DEVICE_TOKEN, FCM_REGISTRATION_FAILED)
-- Add comprehensive input validation for projectId and metadata
-- Improve error handling in LinkHandler with return status
-- Standardize debug logging with consistent PNTA prefixing
-
-## 1.0.0-dev.3
-
-Stable version with a bunch of improvements
+-   Initial stable release of PNTA Flutter plugin.

README.md

@@ -17,8 +17,7 @@ A Flutter plugin for requesting push notification permissions and handling notif
     -   [Android Setup](#android-setup)
 -   [Quick Start Guide](#quick-start-guide)
 -   [API Reference](#api-reference)
--   [Simple Example](#simple-example)
--   [Troubleshooting](#troubleshooting)
+-   [Example](#example)
 
 ## Installation & Setup
 
@@ -296,114 +295,6 @@ await PntaFlutter.initialize('prj_XXXXXXXXX', metadata: UserMetadata.current);
 await PntaFlutter.updateMetadata(UserMetadata.current);
 ```
 
-## Simple Example
-
-```dart
-import 'package:flutter/material.dart';
-import 'package:pnta_flutter/pnta_flutter.dart';
-
-void main() async {
-  WidgetsFlutterBinding.ensureInitialized();
-
-  // One-line setup - handles permission, registration, and configuration
-  await PntaFlutter.initialize(
-    'prj_XXXXXXXXX',        // Your project ID from app.pnta.io
-    metadata: {
-      'user_id': '123',
-      'user_email': 'user@example.com',
-    },
-  );
-
-  // Optional: Get the device token if you need it for your backend
-  final deviceToken = PntaFlutter.deviceToken;
-  if (deviceToken != null) {
-    print('Device registered successfully! Token: $deviceToken');
-  }
-
-  runApp(MyApp());
-}
-
-class MyApp extends StatelessWidget {
-  @override
-  Widget build(BuildContext context) {
-    return MaterialApp(
-      navigatorKey: PntaFlutter.navigatorKey, // Required for deep linking
-      home: HomePage(),
-    );
-  }
-}
-
-class HomePage extends StatefulWidget {
-  @override
-  _HomePageState createState() => _HomePageState();
-}
-
-class _HomePageState extends State<HomePage> {
-  @override
-  void initState() {
-    super.initState();
-    _setupNotifications();
-  }
-
-  void _setupNotifications() async {
-    // If you used initialize() with requestPermission: true, this is already done!
-    // Otherwise, for delayed permission scenarios:
-    // await PntaFlutter.requestPermission(
-    //   metadata: {
-    //     'user_id': '123',
-    //     'user_email': 'user@example.com',
-    //   },
-    // );
-
-    // Listen for foreground notifications
-    PntaFlutter.foregroundNotifications.listen((payload) {
-      ScaffoldMessenger.of(context).showSnackBar(
-        SnackBar(content: Text('Received: ${payload['title']}')),
-      );
-    });
-
-    // Listen for background notification taps
-    PntaFlutter.onNotificationTap.listen((payload) {
-      print('User tapped notification: ${payload['title']}');
-    });
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    return Scaffold(
-      appBar: AppBar(title: Text('PNTA Example')),
-      body: Center(child: Text('Ready for notifications!')),
-    );
-  }
-}
-```
+## Example
 
 For a complete working example with all features, see the `example/` app in the plugin repository.
-
-## Troubleshooting
-
-### Common Issues
-
-**Permission not granted on Android:**
-
--   Ensure `POST_NOTIFICATIONS` permission is in AndroidManifest.xml
--   For Android 13+, permission must be requested at runtime
-
-**Firebase issues:**
-
--   Verify `google-services.json` is in the correct location
--   Check that Firebase project is properly configured
--   Ensure Google Services plugin is applied
-
-**Deep links not working:**
-
--   Verify `navigatorKey` is assigned to MaterialApp
--   Check that routes are properly defined
--   For external URLs, ensure `<queries>` block is in AndroidManifest.xml
-
-**iOS build issues:**
-
--   Clean and rebuild: `flutter clean && flutter pub get`
--   Update Podfile and run `cd ios && pod install`
-
-For more examples and advanced usage, see the `example/` directory in the plugin repository.

android/src/main/kotlin/io/pnta/pnta_flutter/PntaFlutterPlugin.kt

@@ -128,6 +128,10 @@ class PntaFlutterPlugin: FlutterPlugin, MethodCallHandler, ActivityAware, Plugin
     if (extras != null && !extras.isEmpty) {
       val payload = mutableMapOf<String, Any>()
       for (key in extras.keySet()) {
+        if (key.startsWith("google.") || key.startsWith("gcm.") || 
+            key == "from" || key == "collapse_key") {
+          continue
+        }
         val value = extras.get(key)
         when (value) {
           is String, is Int, is Boolean, is Double, is Float, is Long -> payload[key] = value
@@ -138,6 +142,6 @@ class PntaFlutterPlugin: FlutterPlugin, MethodCallHandler, ActivityAware, Plugin
         NotificationTapHandler.sendTapPayload(payload)
       }
     }
-    return false // allow other listeners to process
+    return false
   }
 }

example/lib/main.dart

@@ -1,113 +1,108 @@
 import 'package:flutter/material.dart';
 import 'package:pnta_flutter/pnta_flutter.dart';
 
-void main() {
-  runApp(const MyApp());
+void main() async {
+  WidgetsFlutterBinding.ensureInitialized();
+
+  await PntaFlutter.initialize(
+    'prj_k3e0Givq', // replace with your project id
+    metadata: {
+      'user_id': '123',
+      'user_email': 'user@example.com',
+    },
+    autoHandleLinks: true,
+    showSystemUI: true,
+  );
+
+  runApp(MyApp());
 }
 
 class MyApp extends StatelessWidget {
   const MyApp({super.key});
+
   @override
   Widget build(BuildContext context) {
     return MaterialApp(
       navigatorKey: PntaFlutter.navigatorKey,
-      home: const HomeScreen(),
+      home: HomePage(),
+      routes: {
+        '/profile': (context) => ProfilePage(),
+      },
     );
   }
 }
 
-class HomeScreen extends StatefulWidget {
-  const HomeScreen({super.key});
+class HomePage extends StatefulWidget {
+  const HomePage({super.key});
+
   @override
-  State<HomeScreen> createState() => _HomeScreenState();
+  State<HomePage> createState() => _HomePageState();
 }
 
-class _HomeScreenState extends State<HomeScreen> {
-  String? _deviceToken;
-  String? _lastNotificationTap;
-  String? _foregroundLink;
-  final List<Map<String, dynamic>> _foregroundNotifications = [];
-  bool _loading = true;
+class _HomePageState extends State<HomePage> {
+  String? _lastNotification;
 
   @override
   void initState() {
     super.initState();
-    _initPnta();
+
     PntaFlutter.foregroundNotifications.listen((payload) {
-      setState(() {
-        _foregroundNotifications.insert(0, payload);
-        final link = payload['link_to'] as String?;
-        if (link != null && link.isNotEmpty) {
-          _foregroundLink = link;
-        }
-      });
+      setState(() => _lastNotification = 'Foreground: ${payload.toString()}');
     });
+
     PntaFlutter.onNotificationTap.listen((payload) {
-      setState(() {
-        _lastNotificationTap = payload.toString();
-      });
+      setState(() => _lastNotification = 'Tap: ${payload.toString()}');
     });
   }
 
-  Future<void> _initPnta() async {
-    await PntaFlutter.initialize(
-      'prj_k3e0Givq',
-      metadata: {
-        'user_id': '123',
-        'email': 'user@example.com',
-        'role': 'tester',
-      },
-      autoHandleLinks: false, // We'll handle links manually for demo
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      appBar: AppBar(title: Text('PNTA Example')),
+      body: Center(
+        child: Column(
+          mainAxisAlignment: MainAxisAlignment.center,
+          children: [
+            Icon(Icons.notifications, size: 64, color: Colors.blue),
+            SizedBox(height: 16),
+            Text(
+              'Push notifications ready!',
+              style: Theme.of(context).textTheme.headlineSmall,
+            ),
+            SizedBox(height: 8),
+            Text(
+                'Device token: ${PntaFlutter.deviceToken != null ? "Available" : "Not available"}'),
+            if (PntaFlutter.deviceToken != null)
+              SelectableText(
+                PntaFlutter.deviceToken!,
+                style: TextStyle(fontSize: 10, fontFamily: 'monospace'),
+              ),
+            if (_lastNotification != null) ...[
+              SizedBox(height: 16),
+              Padding(
+                padding: EdgeInsets.symmetric(horizontal: 24),
+                child: SelectableText(
+                  _lastNotification!,
+                  style: TextStyle(fontSize: 10, fontFamily: 'monospace'),
+                ),
+              ),
+            ],
+          ],
+        ),
+      ),
     );
-    setState(() {
-      _deviceToken = PntaFlutter.deviceToken;
-      _loading = false;
-    });
   }
+}
+
+class ProfilePage extends StatelessWidget {
+  const ProfilePage({super.key});
 
   @override
   Widget build(BuildContext context) {
     return Scaffold(
-      appBar: AppBar(title: const Text('PNTA Metadata & Foreground Demo')),
-      body: Padding(
-        padding: const EdgeInsets.all(24),
-        child: _loading
-            ? const Center(child: CircularProgressIndicator())
-            : Column(
-                crossAxisAlignment: CrossAxisAlignment.start,
-                children: [
-                  const Text('Device Token:'),
-                  SelectableText(_deviceToken ?? 'No token (denied or error)'),
-                  const SizedBox(height: 24),
-                  const Text('Foreground Notifications:'),
-                  if (_foregroundNotifications.isEmpty) const Text('None'),
-                  for (final notif in _foregroundNotifications)
-                    Card(
-                      child: Padding(
-                        padding: const EdgeInsets.all(8.0),
-                        child: Text(notif.toString()),
-                      ),
-                    ),
-                  const SizedBox(height: 24),
-                  if (_foregroundLink != null) ...[
-                    ElevatedButton(
-                      onPressed: () async {
-                        final link = _foregroundLink;
-                        if (link != null) {
-                          await PntaFlutter.handleLink(link);
-                          setState(() {
-                            _foregroundLink = null;
-                          });
-                        }
-                      },
-                      child: const Text('Open Foreground Link'),
-                    ),
-                    const SizedBox(height: 16),
-                  ],
-                  const Text('Last Notification Tap Payload:'),
-                  SelectableText(_lastNotificationTap ?? 'None'),
-                ],
-              ),
+      appBar: AppBar(title: Text('Profile')),
+      body: Center(
+        child: Text('Profile page opened via deep link!'),
       ),
     );
   }

example/pubspec.lock

@@ -189,7 +189,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "1.0.0-dev.5"
+    version: "1.0.0"
   process:
     dependency: transitive
     description:

lib/src/version.dart

@@ -1,3 +1,3 @@
 /// PNTA Flutter SDK version
 /// This should match the version in pubspec.yaml
-const String kPntaSdkVersion = '1.0.0-dev.5';
+const String kPntaSdkVersion = '1.0.0';

pubspec.yaml

@@ -1,6 +1,6 @@
 name: pnta_flutter
 description: "Official PNTA Flutter plugin to make push notifications suck less."
-version: 1.0.0-dev.5
+version: 1.0.0
 homepage: https://pnta.io
 repository: https://github.com/pnta-io/pnta-flutter-plugin
 documentation: https://docs.pnta.io