iOS push notifications have no sound - missing sound field in FCM/APNs payload

[zip085]

Problem

Push notifications on iOS arrive silently (banner appears, no sound). All settings enabled:

• Admin dashboard: "Enable Push Notifications" — ON
• App profile: "Enable Notifications" — ON
• iOS Settings → Databag → Notifications → Sounds — ON

Root Cause

In net/repeater/internal/api_notify.go, the FCM message is sent without platform-specific configuration:

notification := &messaging.Notification{ Title: msg.Title, Body: msg.Body }
message := &messaging.Message{
    Notification: notification,
    Token:        msg.Token,
}

Per Apple documentation, iOS requires an explicit "sound" field in the APNs aps payload to play a notification sound.
Without it, notifications are delivered silently.

References:

• Apple APNs Payload Key Reference: https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/PayloadKeyReference.html
• Firebase FCM cross-platform messages: https://firebase.google.com/docs/cloud-messaging/customize-messages/cross-platform
• Firebase Go SDK messaging.Aps struct (Sound field): https://pkg.go.dev/firebase.google.com/go/v4/messaging#Aps
• Firebase Go SDK messaging.AndroidNotification struct (Sound field): https://pkg.go.dev/firebase.google.com/go/v4/messaging#AndroidNotification

Suggested Fix

In net/repeater/internal/api_notify.go, replace the message construction (around line 44) with:

notification := &messaging.Notification{ Title: msg.Title, Body: msg.Body }
message := &messaging.Message{
    Notification: notification,
    Token:        msg.Token,
    Android: &messaging.AndroidConfig{
        Notification: &messaging.AndroidNotification{
            Sound: "default",
        },
    },
    APNS: &messaging.APNSConfig{
        Payload: &messaging.APNSPayload{
            Aps: &messaging.Aps{
                Sound: "default",
            },
        },
    },
}

All struct types (AndroidConfig, AndroidNotification, APNSConfig, APNSPayload, Aps) are from the firebase.google.com/go/v4/messaging package already imported in the file. No new dependencies required.

Additional Notes

• A Payload struct with a Sound field is defined in net/server/internal/api_setPushEvent.go but is dead code — never used in the actual push flow
• The real push path is: SendPushEvent() → HTTP POST to repeater.coredb.org/notify → Notify() in repeater → FCM SDK
• Previously reported in Discussion Feature Request: iOS App Notification Sound #20. A fix was committed but the issue persists on balzack/databag:latest as of Feb 2026