Push to iPhone and iPad.

import { readFileSync } from "node:fs";
import { Notify } from "@productcraft/notify";

const notify = new Notify();

// Validated against Apple before it is stored; a wrong key is a 422
// CREDENTIAL_INVALID and nothing is saved. Stored encrypted, never returned.
const credential = await notify.channels.apns.uploadCredential({
  key_id: "ABC123DEFG", // shown next to the key in your Apple Developer account
  team_id: "9XYZ8W7V6U", // your Apple developer team id
  bundle_id: "com.example.app",
  environment: "both", // debug builds (sandbox) and TestFlight/App Store (production)
  p8: readFileSync("AuthKey_ABC123DEFG.p8", "utf8"),
});
console.log(credential.fingerprint); // all the console ever shows again

import UIKit
import UserNotifications

final class AppDelegate: NSObject, UIApplicationDelegate {
  func application(_ app: UIApplication, didFinishLaunchingWithOptions _: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool {
    // Ask from a moment that makes sense to the user (not at first launch, ideally).
    UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .badge, .sound]) { granted, _ in
      guard granted else { return }
      DispatchQueue.main.async { app.registerForRemoteNotifications() }
    }
    return true
  }

  // Called on every launch after registration: send the token every time.
  func application(_: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    let token = deviceToken.map { String(format: "%02x", $0) }.joined()
    #if DEBUG
    let environment = "sandbox"     // Xcode builds talk to the APNs sandbox
    #else
    let environment = "production"  // TestFlight and App Store builds
    #endif
    Task { try? await NotifyAPI.registerDevice(token: token, environment: environment) }
  }
}

enum NotifyAPI {
  /// Registers through the client API with the recipient token your backend minted.
  static func registerDevice(token: String, environment: String) async throws {
    var req = URLRequest(url: URL(string: "https://api.notify.productcraft.co/v1/client/devices")!)
    req.httpMethod = "POST"
    req.setValue("Bearer \(try await Session.notifyToken())", forHTTPHeaderField: "Authorization")
    req.setValue("application/json", forHTTPHeaderField: "Content-Type")
    req.httpBody = try JSONSerialization.data(withJSONObject: [
      "channel": "apns",
      "token": token,
      "app_id": Bundle.main.bundleIdentifier!,
      "environment": environment,
      "timezone": TimeZone.current.identifier,
    ])
    let (data, _) = try await URLSession.shared.data(for: req)
    // Keep the device id: DELETE /v1/client/devices/{id} on logout.
    let device = try JSONSerialization.jsonObject(with: data) as? [String: Any]
    UserDefaults.standard.set(device?["id"] as? String, forKey: "notifyDeviceId")
  }
}

await notify.recipients.devices.create("user_123", {
  channel: "apns",
  token: "f1c2…", // hex string from didRegisterForRemoteNotificationsWithDeviceToken
  app_id: "com.example.app", // the bundle id the key sends to
  environment: "sandbox", // "production" for TestFlight and App Store builds
  timezone: "Europe/Lisbon",
});

await notify.notificationTypes.replaceByKey("order.shipped", {
  name: "Order shipped",
  category_key: "orders",
  routing: { always: ["inbox"], fallback: [{ channel: "push" }, { channel: "email" }] },
  templates: [
    { channel: "inbox", locale: "en", body: { title: "Your order is on its way", body: "Tracking: {{tracking}}" } },
    {
      channel: "push",
      locale: "en",
      body: {
        title: "Your order is on its way",
        body: "Arrives {{eta}}",
        url: "https://app.example.com/orders/{{order_id}}",
        image_url: "https://cdn.example.com/products/{{sku}}.jpg", // rich push: needs a Notification Service Extension
        badge: "unread_count", // the app icon shows the inbox's unread count
        thread_id: "orders",
        apns_overrides: { aps: { "relevance-score": 0.8 } },
      },
    },
    { channel: "email", locale: "en", body: { mail_template_name: "order-shipped" } },
  ],
});