Этап 4: PWA и пуши — service worker, Web Push с VAPID, баннер установки

Сервер: пакет push на webpush-go (третья и последняя прямая зависимость),
подписка устройства, правило ADR-023 «пуш только молчащему устройству и только
один» через атомарный захват push_pending, удаление подписки на 404 и 410,
TTL сутки, urgency normal. В нагрузке только {title, body, chat} — тело
собирается из константы, плейнтекст туда не попадает даже по ошибке.

Клиент: service worker с версионированным кэшем оболочки и никогда — /api/*,
push и notificationclick, подписка на VAPID-ключ сервера, запрос разрешения
после первого отправленного сообщения, разделы настроек «уведомления»
и «установить приложение», баннер установки на iOS.

ADR-045: пуш адресован получателю — по букве ADR-023 он уходил бы и молчащему
устройству отправителя с бессмысленным заголовком из собственного ника.
ADR-047: сервер ходит на endpoint подписки, который выбирает браузер. Проверка
«только https» обходилась редиректом, а имя могло смотреть внутрь сети — теперь
запрет редиректов и проверка разрешённого адреса на уровне сокета.
ADR-048: пределы отправки — недоступный push-сервис одного аккаунта больше
не съедает пуши всего сервера.
ADR-049: явно выключенные уведомления сами не включаются обратно.

Попутно: webpush-go дописывает набивку в переданный срез, а одна нагрузка
уходила всем устройствам сообщения — гонка, пойманная go test -race.
Теперь у каждого задания своя копия.

Приёмка на боевом: подписки, hasPush, чужое устройство, Origin, оболочка
из девяти файлов, Service-Worker-Allowed. Отдельно шесть непубличных адресов
и endpoint на 3 КиБ — все отбиты.

Чеклист ручной проверки на iPhone и Android — в docs/plan.md.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015DbCjVfTFq4ZFG8juD45YJ

web/js/sync.js

@@ -338,6 +338,17 @@ export function deviceId() {
   return state.device;
 }
 
+// onSent ставит обработчик успешной отправки: по первой из них клиент
+// один раз просит разрешение на уведомления (docs/ui.md, «Уведомления»).
+// «Первой за всю историю устройства» это делает не здесь: транспорт
+// не знает ни про разрешения, ни про то, о чём уже спрашивали. Ставит
+// обработчик main.js.
+let sentHandler = () => {};
+
+export function onSent(handler) {
+  sentHandler = handler;
+}
+
 // --- устройство ---------------------------------------------------------
 
 // ensureDevice — deviceId устройства: 16 случайных байт base64url,
@@ -1518,6 +1529,13 @@ async function post(message, peer, roomId) {
     const sent = { ...message, status: "sent", ts: answer?.ts ?? message.ts };
     await db.saveMessages({ messages: [sent], me: state.nick });
     notify([sent]);
+    // Сообщение ушло: обработчик решает, спрашивать ли разрешение
+    // на уведомления. Отправку он не задерживает и сорвать не может.
+    try {
+      sentHandler();
+    } catch {
+      // Дело обработчика; отправка состоялась.
+    }
     return null;
   } catch (err) {
     // Ответ с кодом — то же доказательство, что запрос дошёл, что и 202: