browser-generation-completion-alert

name	browser-generation-completion-alert
description	Add and verify cross-platform browser notifications and default completion sounds for long-running web jobs. Use when a web UI should alert users after generation, export, rendering, uploads, or other asynchronous work finishes.

Browser Generation Completion Alert

Goal

Notify the user once when a long-running browser job succeeds:

• Use the Web Notifications API for macOS and Windows desktop notifications.
• Use Web Audio for a short built-in chime without an audio asset.
• Keep notification failure isolated from the job result.

Browser constraints

• Request notification permission only from a user gesture, normally the job's submit click.
• Create or resume AudioContext from the same gesture so later background playback is allowed.
• Notifications require a secure context outside localhost.
• A page-only polling implementation cannot notify after the tab or browser is closed. Use server-side push plus a service worker only when closed-page delivery is explicitly required.
• When NotificationOptions.silent is omitted, notification sound and vibration follow platform conventions and are not guaranteed. silent: true suppresses notification-originated sound and vibration in supporting browsers.
• NotificationOptions.silent is not Baseline across all widely used browsers. Define the supported browser matrix and verify sound-on and sound-off behavior on each target browser and OS pair; do not infer support from the OS alone.

Sound policy

Choose exactly one sound source:

• For an app-controlled chime, create the desktop notification with silent: true and play Web Audio only when the app sound setting is enabled. This avoids a duplicate OS notification sound. The chime follows site/tab mute and device audio volume, but not OS notification-sound or Focus/Do Not Disturb semantics.