Files
mechanic-pwa/driver-pwa/frontend/src/lib/push.ts
T
tremble7681andClaude Opus 5 7d8f4b8998 feat(login): вход по номеру телефона основным способом + починка уведомлений
Экран входа через МТС ID (/login/mts) и перестановка приоритетов: «Войти по
номеру телефона» теперь первая кнопка, Telegram и код ушли вниз запасными.
Показ решает бэкенд (/driver/auth/mts/status), а не флаг во фронте: пустой
client_id возвращает Telegram на первое место — экрана без единой кнопки входа
быть не должно.

Отказ оператора ведёт в Telegram, а не в повтор. Причина денежная: каждая
попытка через оператора платная, и при сбое доставки (видели на Tele2) водитель
сжигал бы по нескольку подряд, так и не войдя.

От Seamless отказались. Запрос к оператору обязан уйти с устройства по HTTP, а мы
работаем по HTTPS: из кода это режет mixed content, и остаётся всплывающее окно,
которое установленное PWA даёт через раз. Две живые проверки дали СМС, а выигрыш
был бы в секундах, не в деньгах. Тест сторожит, чтобы окно не вернулось молча.

Починки, найденные по дороге:

* поле телефона срезало ведущую «7», но не «8»: набор с восьмёрки давал сдвинутый
  номер (+7 890 250-61-09 вместо +7 902 506-10-90) и отказ «номер не найден».
  Плюс «+7» рисовался маской и появлялся лишь после первой цифры — по пустому
  экрану было не понять, с какой цифры начинать. Теперь префикс отдельным
  элементом и виден всегда;
* подписка на пуши расходилась с сервером молча. `currentState` считал уведомления
  включёнными по наличию подписки В БРАУЗЕРЕ, не спрашивая сервер. Подписка
  переживает выход и смену водителя — после входа другим водителем приложение
  прятало кнопку, а сервер про подписку не знал. Кнопки «выключить» нет намеренно,
  так что выхода из этого состояния не было. Теперь при каждом входе подписка
  молча отдаётся серверу заново (эндпоинт переписывает её на текущего водителя),
  а строка состояния больше не молчит: «Уведомления включены» вместо пустоты;
* `serviceWorker.ready` при незарегистрированном воркере не резолвится НИКОГДА —
  включение зависало без тоста и без следа на сервере. Сторож на 10 секунд;
* любой сбой включения превращался в «Не удалось включить уведомления» без
  причины. Теперь в скобках код: (sw-timeout), (AbortError) — по нему чинится;
* `isStandalone` звал window.matchMedia без проверки: в части WebView его нет, и
  падал бы весь экран входа из-за необязательной подсказки.

Предложение поставить приложение на домашний экран — на экране входа. Где браузер
даёт `beforeinstallprompt` (Chrome, Edge, Samsung) — настоящая кнопка установки;
на iOS дословная инструкция, потому что без установки там не работают пуши вовсе.
Слушатель события висит с загрузки модуля: Chrome стреляет им один раз и обычно
до монтирования React.

В текстах для водителя убраны штрафы и долги как повод что-то сделать: «поставьте
приложение, чтобы мы сообщали о штрафах» читается угрозой и работает против самой
просьбы. Зовём удобством.

Иконки: углы были залиты белым, скругление нарисовано прямо в файле. У maskable
это ломало Android — он обрезает своей маской, а там вокруг скруглённого квадрата
ещё и белые поля. Все четыре пересобраны как плоский красный с белым глифом;
скругление отдано системе.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-22 21:53:49 +10:00

171 lines
9.1 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { getPushKey, subscribePush, unsubscribePush } from "@/api/driver";
/**
* Включение уведомлений в приложении.
*
* Главное правило экрана вокруг этого кода: разрешение спрашивается ОДИН раз за
* всю жизнь установки. Отказ браузер запоминает, переспросить нельзя — только
* руками в настройках сайта, куда водитель не пойдёт. Поэтому запрос идёт
* строго по нажатию и только когда сервер подтвердил, что уведомления настроены.
*/
export type PushState =
| "unsupported" // браузер не умеет (или iOS без установки на домашний экран)
| "needs-install" // iOS: умеет, но только когда приложение добавлено на экран
| "denied" // разрешение отклонено — переспросить нечем
| "off" // можно включить
| "on"; // подписка есть
/** Приложение открыто как установленное (с домашнего экрана), а не вкладкой. */
export function installed(): boolean {
return isStandalone();
}
function isStandalone(): boolean {
// matchMedia есть не везде: его нет в jsdom и в части WebView, а падение здесь
// роняло бы весь экран входа из-за необязательной подсказки про установку.
const standaloneByMedia =
typeof window.matchMedia === "function" &&
window.matchMedia("(display-mode: standalone)").matches;
return standaloneByMedia ||
// iOS до 17 не поддерживает display-mode: standalone в matchMedia
(navigator as { standalone?: boolean }).standalone === true;
}
function isIos(): boolean {
return /iPad|iPhone|iPod/.test(navigator.userAgent);
}
export function supported(): boolean {
return "serviceWorker" in navigator && "PushManager" in window && "Notification" in window;
}
export async function currentState(): Promise<PushState> {
if (!supported()) return isIos() && !isStandalone() ? "needs-install" : "unsupported";
if (Notification.permission === "denied") return "denied";
const reg = await navigator.serviceWorker.getRegistration();
const sub = await reg?.pushManager.getSubscription();
return sub ? "on" : "off";
}
/** base64url → байты: ключ VAPID браузер принимает только так.
* Возвращаем ArrayBuffer, а не Uint8Array: типы DOM ждут BufferSource. */
function keyToBytes(base64: string): ArrayBuffer {
const padded = base64.replace(/-/g, "+").replace(/_/g, "/") +
"=".repeat((4 - (base64.length % 4)) % 4);
const raw = atob(padded);
const bytes = new Uint8Array(raw.length);
for (let i = 0; i < raw.length; i++) bytes[i] = raw.charCodeAt(i);
return bytes.buffer;
}
/** Сколько ждём готовности service worker'а, прежде чем признать, что его нет.
*
* `navigator.serviceWorker.ready` — промис, который при незарегистрированном или
* не взявшем управление воркере не резолвится НИКОГДА. Без ограничения включение
* уведомлений просто зависало: кнопка крутилась до закрытия приложения, тоста не
* было, в журнале сервера — тишина. Именно так это и выглядело 22.09.2026:
* приложение забрало ключ VAPID и на этом замолчало. */
const SW_READY_TIMEOUT_MS = 10_000;
class PushError extends Error {
constructor(public readonly code: string, message: string) {
super(message);
this.name = "PushError";
}
}
async function swReady(): Promise<ServiceWorkerRegistration> {
let timer: ReturnType<typeof setTimeout>;
const timeout = new Promise<never>((_, reject) => {
timer = setTimeout(
() => reject(new PushError("sw-timeout", "service worker не готов")),
SW_READY_TIMEOUT_MS);
});
try {
return await Promise.race([navigator.serviceWorker.ready, timeout]);
} finally {
clearTimeout(timer!);
}
}
/** Короткий код случившегося — его показываем в тосте и по нему чинят.
* Универсальный текст без кода уже стоил нам вечера догадок. */
export function errorCode(e: unknown): string {
if (e instanceof PushError) return e.code;
const name = (e as { name?: string })?.name;
return name && name !== "Error" ? name : "неизвестно";
}
/** Отдать серверу подписку, которая уже есть в браузере. True — отдали.
*
* Зачем это нужно отдельно от `enable`. Подписка живёт в браузере и переживает
* и выход, и смену водителя, а `currentState` считает уведомления включёнными
* ровно по её наличию — про сервер он не спрашивает. Отсюда тупик, в который мы
* попали 22.09.2026: на одном телефоне вошли сначала одним водителем, потом
* другим; подписка в браузере осталась, приложение решило «включено» и спрятало
* кнопку, а на сервере записи для текущего водителя нет. Кнопки «выключить» у
* нас нет намеренно, так что выйти из этого состояния было нечем — уведомления
* просто молча не приходили.
*
* Хуже того, без этого вызова подписка на сервере осталась бы привязанной к
* ПРЕЖНЕМУ водителю, и его уведомления о деньгах прилетали бы на телефон,
* которым пользуется уже другой человек.
*
* Эндпоинт переписывает подписку по endpoint на текущего водителя, поэтому
* вызов идемпотентен: звать можно при каждом открытии.
*/
export async function syncSubscription(): Promise<boolean> {
if (!supported()) return false;
const reg = await navigator.serviceWorker.getRegistration();
const sub = await reg?.pushManager.getSubscription();
if (!sub) return false;
const json = sub.toJSON() as { endpoint?: string; keys?: { p256dh?: string; auth?: string } };
await subscribePush({
endpoint: json.endpoint ?? sub.endpoint,
p256dh: json.keys?.p256dh ?? "",
auth: json.keys?.auth ?? "",
});
return true;
}
/** Включить уведомления. Возвращает новое состояние. */
export async function enable(): Promise<PushState> {
if (!supported()) return currentState();
const { key, enabled } = await getPushKey();
// Ключа нет — сервер уведомления не отправляет. Разрешение не спрашиваем:
// потратить единственную попытку впустую нельзя.
if (!enabled || !key) return "off";
const permission = await Notification.requestPermission();
if (permission !== "granted") return permission === "denied" ? "denied" : "off";
const reg = await swReady();
// Подписка могла остаться с прошлого раза. Повторный `subscribe` с другим
// ключом бросает InvalidStateError, а с тем же — вернёт эту же подписку;
// переиспользовать её и дешевле, и надёжнее.
const sub = (await reg.pushManager.getSubscription()) ?? await reg.pushManager.subscribe({
userVisibleOnly: true,
applicationServerKey: keyToBytes(key),
});
const json = sub.toJSON() as { endpoint?: string; keys?: { p256dh?: string; auth?: string } };
await subscribePush({
endpoint: json.endpoint ?? sub.endpoint,
p256dh: json.keys?.p256dh ?? "",
auth: json.keys?.auth ?? "",
});
return "on";
}
/** Выключить: снимаем подписку и в браузере, и на сервере. */
export async function disable(): Promise<PushState> {
const reg = await navigator.serviceWorker.getRegistration();
const sub = await reg?.pushManager.getSubscription();
if (sub) {
// Сначала сервер: не сумеем достучаться — подписка останется живой, и
// уведомления продолжат приходить, а это лучше «выключил, а они идут».
await unsubscribePush(sub.endpoint);
await sub.unsubscribe();
}
return "off";
}