feat: push notifications

[sgammon]

Summary

Adds initial support wiring for Push Notifications (see: #11651).

This requires instrumentation down into tao, to call methods on the AppDelegate or NSApplication / UIApplication (for Apple platforms). Firebase Messaging (FCM) support is also under consideration.

• [ ] tauri: Handle new events
  • (that's this pr)
  • [x] Forward/map PushRegistration event
  • [x] Forward/map PushRegistrationFailed event
  • [ ] General cleanup (don't repeat typedefs, etc)
• [ ] tao: Hooks into UIApplication / NSApplication
  • tauri-apps/tao#1015
  • [x] Support for macOS
  • [ ] Support for iOS
  • [x] Any considerations for Android
  • [x] Considerations for Windows
• [ ] tauri-plugin-push-notifications:
  • tauri-apps/plugins-workspace#2066
  • [x] Initially working plugin structure (here)
  • [x] Facade for await pushToken(...)
  • [x] Working local test to capture token
  • [x] Add plugin sources to plugins-workspace
  • [ ] Interface for callback-based token access
• [ ] tauri-docs
  • tauri-apps/tauri-docs#2997
  • [x] Add initial Push Notifications plugin page
  • [ ] Validate configuration with example app
• [ ] Platform support
  • [x] macOS (APNS)
  • [ ] iOS (APNS)
  • [ ] Windows (WNS)
  • [x] Android (FCM)

PR Tree

This PR is accompanied by a plugin, tauri-plugin-push-notifications, and a PR to tao:

• Plugin repo
• tauri-apps/tao#1015
• tauri-apps/plugins-workspace#2066
• tauri-apps/tauri-docs#2997

Known Issues

• [ ] General
  • [ ] Token needs strong typing in guest code
• [ ] Docs
  • [ ] macOS and iOS devices need an entitlement, which should be mentioned in the docs.
• [ ] Tests
  • [ ] There are no tests yet.

[!WARNING] This functionality is experimental and is gated behind the push-notifications feature for now.

How it works

(1) tao and tauri forward two new events: PushRegistration(PushToken) and PushRegistrationFailed(Error). (2) a new plugin, tauri-plugin-push-notifications, listens for these events, holds the token or error, and exposes those values to guest code when requested.

sequenceDiagram
    tao->>+OS: Setup app delegate
    OS->>+tao: applicationDidFinishLaunching
    tao->>+OS: registerForRemoteNotifications()
    OS->>+tao: didFinishRegisteringWithToken()
    tao->>+tauri: PushRegistration(PushToken) Event
    tauri->>+Plugin: Forward event
    Plugin->>+Plugin: Retain token in-memory
    tauri->>+App: Launch app
    App<<->>+Plugin: await pushToken()

[ChrisCates]

Any way I can help ship this? That or, what's your ETA for completion brotha?

[sgammon]

@ChrisCates Very close to completion, i'm testing on macOS shortly. I haven't explored Android yet, so some research there might help (how best to integrate Firebase Cloud Messaging - FCM - into tao and tauri; ideally it could work within the plugin only).

Windows is looking solid but I'm not sure how to extract the token yet. That may remain experimental until later if only because I can't find any third party push services that support WNS at this time.

tl;dr I'd say we could get macOS and potentially iOS working within a few days. Android and WNS are probably easier/less complex, but may take a few days longer for research about how best to integrate. Regarding review and merge, I've no clue, this is my first PR to Tauri.