index

notifications

Type Alias	Description
DeviceToken	Зарегистрированный токен: `{ id, userId, expoPushToken, platform }`.
MarkNotificationsReadBody	Тело отметки прочтения: `{ notificationIds }`.
Notification	Уведомление: `{ id, eventType, severity, messageKey, params, targetRoles, targetUserId, resourceType, resourceId, createdAt }`. Текст НЕ приходит отрендеренным (Ось 2) — клиент локализует его своим каталогом по `messageKey` + `params` (как коды ошибок, ADR-0042). Сервер сам фильтрует фид по организации и роли/пользователю.
NotificationMarkReadResult	Результат отметки прочтения: `{ marked }` (число ново отмеченных).
NotificationPage	Страница уведомлений (cursor-пагинация): `{ items, nextCursor }`.
NotificationUnreadCount	Счётчик непрочитанных: `{ count }`.
RegisterDeviceTokenBody	Тело регистрации push-токена: `{ expoPushToken, platform }`.

Function	Description
useNotifications	REST-backlog уведомлений получателя (cursor-пагинация, новые сверху). Источник истины ленты — realtime (useRealtimeNotifications) префиксит сюда новые, дедуп по id.
useUnreadNotificationsCount	Число непрочитанных уведомлений получателя (BL-08) — для бейджа в UI. Сервер считает адресованные строки без receipt'а. Под ключом `notifications.unreadCount` (вложен в `notifications.all`) — инвалидация ленты/realtime обновляет и счётчик.

Function	Description
useMarkAllNotificationsRead	Отметить все уведомления прочитанными (BL-08). Идемпотентно. На успехе инвалидирует раздел уведомлений (лента + счётчик непрочитанных).
useMarkNotificationsRead	Отметить уведомления прочитанными (BL-08). Идемпотентно (повторная отметка — no-op); адресность проверяет бэк. На успехе инвалидирует раздел уведомлений (лента + счётчик непрочитанных).
useRegisterDeviceToken	Регистрация Expo push-токена устройства за текущим пользователем (ADR-0069). Idempotent (повторная регистрация того же токена — upsert); `Idempotency-Key` проставляет fetch-слой. Владелец берётся из JWT на бэке — в теле только `{ expoPushToken, platform }`.
useUnregisterDeviceToken	Снятие push-токена устройства по значению (logout, ADR-0069). Idempotent: чужой/несуществующий токен — no-op (204). Org-скоуп и владелец — на бэке.