push_notification_kit 0.4.0
push_notification_kit: ^0.4.0 copied to clipboard
Auth-agnostic Flutter push notifications: FCM token lifecycle, rich notifications (images & action buttons), deep links, and pluggable backend registration. Bring your own auth via a TokenProvider.
0.4.0 #
- Cold-start action support:
PushKitnow captures the notification/action that launched the app from a terminated state (viagetNotificationAppLaunchDetailsfor local-notification action taps, andgetInitialMessagefor FCM taps) and exposes it viaprocessPendingLaunch(). Call it once afterrunApp(router/DI ready) — it firesonActionfor an action-button cold start oronTapotherwise. This closes the gap where accept/decline taps from a killed app were not handled.init()no longer dispatches the cold-start tap itself. - Local-notification payloads now carry the full data block;
PushMessage.fromDatareconstructs the complete message (participantId, type, …) on tap, not just the deep link.
0.3.0 #
- Add engagement reporting:
EngagementReporter(+ bundledHttpEngagementReporterandCallbackEngagementReporter). Pass one asPushKit(reporter: …)and the kit reports an "opened" event on notification tap and a "clicked" event on action- button tap, so the backend can compute open/click rates. Best-effort. - Local-notification payloads now carry the platform
messageId(JSON) so taps on rendered notifications can be attributed.PushMessage.messageIdexposes it.
0.2.0 #
- Add
iosCategoriestoPushKitandrenderBackgroundMessageso hosts can register iOS notification categories (action buttons per category) directly on the kit's plugin instance — previously iOS action buttons required native AppDelegate setup. Android is unchanged (buttons come from messageactions). - Re-export
DarwinNotificationCategory/DarwinNotificationAction(and their option enums) from the package so hosts don't need a direct flutter_local_notifications import.
0.1.0 #
- Initial release.
- Auth-agnostic FCM lifecycle: permissions, token retrieval (iOS APNS retry), refresh, auth-gated registration, foreground/background handling.
- Rich notifications: downloaded images (Android BigPicture), action buttons, iOS categories.
- Deep-link tap and action-button callbacks; cold-start handling.
- Pluggable
TokenProviderandDeviceRegistrar(+ bundledHttpDeviceRegistrar).