Push notifications for new tags and imported folders

[semohr]

This PR introduces the foundational functionality for sending and receiving push notifications to registered devices. It includes everything necessary to implement basic notification flows, including sending from the backend and displaying on the client side.

This is a draft! And we still have to implement quite some things to get this working.

TODOs:

• register new subscriptions (push + webhooks)
• define triggers for notifications including settings
• display notifications

Technicals

• The system uses VAPID (Voluntary Application Server Identification) keys for secure Web Push communication per deployment.
• Keys are automatically generated on first run if they don't exist.
• Generated keys are stored persistently in the Beets Flask config directory, ensuring they're reused across server restarts.
• Notifications are sent using the Web Push protocol via the pywebpush library.
• Devices register their push subscription (endpoint + keys) with the server (placed in new sql table)
• Service worker is transpiled and registered using vite, which allows us to display notification on the client (worker.ts)

[github-actions]

Thank you for the PR! The changelog has not been updated, so here is a friendly reminder to check if you need to add an entry.

[0xC0ncord]

This would be super useful to me! But, would it be possible to also allow configuring a webhook URL for notifications on the server-side? This would allow me to instead forward notifications to e.g. a ntfy server or Discord channel.

[semohr]

I'm not currently using ntfy myself, and from what I’ve seen, the standard Web Push + Notification API seems a lot more powerful, at least for enabling interactions directly within our app. In general, I lean toward supporting open standards first, since they offer the broadest compatibility. But once that’s solid, adapting it to send messages to alternative services could definitely be doable.

That said, it should be relatively straightforward to patch the server-side notification function to forward messages to additional endpoints, assuming some kind of configuration is enabled.

I won’t prioritize support for external endpoints right now, but I’ll keep it in mind, especially when considering the database representation of push subscribers.

[bendardenne]

I'm also interested in this.

The use case for me would be mostly to be notified of failed imports / whenever manual interaction would be required.

beets-flask for me replaces a homebrewed shell script that would import music. That shell script used to use ntfy.sh for notifications, but TBH I don't really care how the notification gets there.

For what it's worth, from what I've seen in other projects, Apprise is the de facto standard for this. The major benefits is that it comes with a python library, where you should be able to let users configure a pretty simple endpoint in the config (e.g. email:// , ntfy://, discord://, gotify:// ...) and you get support for all of those for free (on the backend you'd basically just need to apprise.send whenever needed, or whatever the actual API is, but it's pretty straigthforward). Their github claims to support VAPID as well, but it seems undocumented.