iOS critical alert, interruption level ve ses

await hs.notifications.create({
  target: { include_external_ids: ['user_42'] },
  headings: { tr: 'Güvenlik uyarısı' },
  contents: { tr: 'Hesabınıza yeni cihazdan giriş yapıldı' },
  ios_interruption_level: 'time-sensitive',
  ios_sound: 'alert.caf',
  thread_id: 'security',
});
```text

`ios_interruption_level: 'critical'` değeri yalnızca entitlement'ı olan uygulamalara gönderilmelidir; entitlement yoksa APNs isteği reddetmez, ancak cihaz bildirimi normal (`active`) seviyede gösterir.

## 3. Critical alert kurulumu ve mevcut davranış

### Apple tarafı

1. [Critical alert entitlement başvurusu](https://developer.apple.com/contact/request/notifications-critical-alerts-entitlement/) yapın (sağlık, güvenlik, kamu güvenliği gibi kullanım alanları gerekir).
2. Onay sonrası App ID'ye **Critical Alerts** yeteneğini ekleyin; `.entitlements` dosyasına `com.apple.developer.usernotifications.critical-alerts = true`.
3. İzin isteminde `.criticalAlert` seçeneğini ekleyin. Pushizo iOS SDK'sının `Pushizo.Notifications.requestPermission` çağrısı `[.alert, .badge, .sound]` (+ `provisionalAuthorization` açıksa `.provisional`) ister; `.criticalAlert` istemez. Bu nedenle critical alert iznini uygulamanız ayrıca istemelidir:

```swift
import UserNotifications

func requestCriticalAlerts() {
    UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .badge, .sound, .criticalAlert]) { granted, _ in
        // Kullanıcı critical alert iznini ayrı bir anahtarla yönetir (Ayarlar → Bildirimler → uygulama → Kritik Uyarılar)
    }
}
```text

Bu çağrı Pushizo SDK'sının izin takibiyle çelişmez: SDK etkin izni `UNUserNotificationCenter.getNotificationSettings` üzerinden okur ve abonelik `push_capable` bilgisini günceller; `addPermissionObserver` değişikliği bildirir.

### Pushizo tarafı (mevcut davranış)

- `ios_interruption_level: "critical"` → `aps.interruption-level: "critical"` yazılır.
- `ios_sound` → `aps.sound: "<dosya>"` (dize). Apple'ın critical alert için tanımladığı `aps.sound = { "critical": 1, "name": "…", "volume": 0.0–1.0 }` sözlüğü ve dolayısıyla **hacim ezmesi (volume) desteklenmez**; ses cihaz ayarındaki hacimle çalar. Bu alanlar eklendiğinde `MessageContent` (`packages/db/src/schema/delivery.ts`) ve OpenAPI sözleşmesi genişletilecek, mevcut alanlar değişmeyecektir (ekleme kırıcı değildir).
- Notification Service Extension (`PushizoExtension`) `aps` içeriğini `mutableCopy` ile korur; `interruption-level` ve `sound` değerleri NSE'den geçerken değişmez. NSE bir bildirimi critical seviyeye yükseltemez (bu yalnızca payload + entitlement ile mümkündür).
- Critical ve time-sensitive seviyeler sessiz saatler ve frekans sınırından otomatik muaf değildir; işlemsel/kritik mesajlarda `quiet_hours_exempt: true` ve `frequency_cap_exempt: true` alanlarını birlikte gönderin.

## 4. Ses

- `ios_sound`: uygulama paketindeki özel ses (`alert.caf`); `default` sistem sesi. Dosya bulunamazsa iOS varsayılan sesi çalar.
- Sessiz push (`content_available: true`) ses göndermez.
- Android'de karşılık `android_sound` (`res/raw/<ad>`), ya da Dashboard → Ayarlar → Android bildirim kategorileri içindeki kanal sesi (`android_channel_id`). Android 8+ sesi kanal belirler; mesaj başına ses yalnızca kanal yoksa uygulanır.
- Web'de ses tarayıcı/işletim sistemi ayarıdır; mesaj alanı yoktur.

## 5. Doğrulama

1. Test cihazında (gerçek cihaz; simülatörde APNs yoktur) uygulamayı `sandbox` ortamıyla çalıştırın, Dashboard → **Kanallar → iOS Push** ortamının eşleştiğini doğrulayın (`BadDeviceToken` ortam uyumsuzluğudur).
2. Cihazı **Rahatsız Etme**'ye alın; `time-sensitive` mesaj gelmeli, `active` mesaj özette kalmalıdır.
3. Critical alert entitlement'ı olan uygulamada cihazı sessize alıp `ios_interruption_level: "critical"` gönderin; ses çalmalıdır. Entitlement yoksa bildirim normal seviyede gelir, bu beklenen davranıştır.
4. **Mesaj İzleme**'de `sent → received → opened` zaman çizelgesi; `received` kaydı NSE tarafından yapılır (`PushizoExtension` eklenmemişse yalnızca `opened` görünür).