Push notifications

┌─────────────────────────────────────────────┐
│                   APNs                       │
└─────────────────┬───────────────────────────┘
                  │
    ┌─────────────┴─────────────┐
    │                           │
    ▼                           ▼
┌─────────────────┐   ┌─────────────────────────┐
│ Notification    │   │ Main App                │
│ Service Ext     │   │ (foreground delivery)   │
│ (background)    │   │                         │
└────────┬────────┘   └────────────┬────────────┘
         │                         │
         ▼                         ▼
┌─────────────────┐   ┌─────────────────────────┐
│ Rich content    │   │ PushManager             │
│ (avatar, image) │   │ (routing, handling)     │
└─────────────────┘   └─────────────────────────┘

@MainActor
final class PushManager: NSObject, ObservableObject {
    static let shared = PushManager()
    @Published var pendingRoute: PushRoute?
}

enum PushRoute: Equatable {
    case dashboard
    case communityLeaderboards
    case campaigns
    case community
    case communityChat(slug: String?)
    case brandHub(publicId: String, tab: PushRouteBrandHubTab)
    case support(ticketId: String?, compose: Bool)
    case creativeApproval(id: String)
    case brandDealDetail(id: String)
    // ... more routes
}

// From target_url
PushRoute.parse("/brands/abc123/hub")
// → .brandHub(publicId: "abc123", tab: .overview)

// From universal link
PushRoute.fromUniversalLink(URL(string: "https://dialed.evo.co/brands/123")!)

// From push payload
PushRoute.fromPushData(notification.userInfo)

let intent = INSendMessageIntent(
    recipients: nil,
    outgoingMessageType: .outgoingMessageText,
    content: body,
    speakableGroupName: nil,
    conversationIdentifier: channelId,
    serviceName: nil,
    sender: sender
)

func registerDeviceToken(_ token: Data) async {
    let tokenString = token.map { String(format: "%02x", $0) }.joined()
    try await api.post("/api/creator/device_tokens", body: [
        "token": tokenString,
        "platform": "ios"
    ])
}

// In shell view
.onChange(of: PushManager.shared.pendingRoute) { route in
    if let route = route {
        consumePushRoute(route)
        PushManager.shared.pendingRoute = nil
    }
}

{
  "aps": {
    "alert": {
      "title": "Test",
      "body": "Test notification"
    }
  },
  "target_url": "/brands/123/hub",
  "kind": "early_viral_alert"
}