@mikitasazan/notify 1.0.0

package/README.md

@@ -0,0 +1,160 @@
+# @mikitasazan/notify
+
+Единая типизированная отправка Telegram-уведомлений: **форум на проект**,
+внутри вкладки «⚙️ Ops» (роботы) и «💬 Dev» (люди), один бот, семь типов
+событий. Заменяет 18 разных имён переменных и 4+ независимых реализации
+`jq | curl`, что были в playhub, arvent, game-publisher до 26.07.2026.
+
+**Почему форум на проект, а не один общий форум с темой на проект.** Второе
+пробовали первым — не работает: Telegram не умеет закрывать отдельную тему от
+участника, кто в группе, видит все вкладки. Значит сотрудников в общий форум
+не пустить, им нужен свой чат — и проект начинает жить в двух местах сразу
+(«тема у владельца» + «канал у команды»). Форум на проект убирает
+дублирование: сотрудник добавляется в форум своего проекта, чужих не видит,
+схема одна для всех.
+
+## Идея в одном абзаце
+
+`notify()` принимает объект (`NotifyEvent`), а не строку — «своё» сообщение
+написать нельзя. Один рендерер на тип события гарантирует одинаковый каркас:
+`эмодзи Заголовок · проект`, затем `ключ: значение`, затем ссылка. Маршрут
+«куда слать» вычисляется из `--project` и severity события — добавить новый
+проект значит дописать одну строку в `src/routes.ts`, больше нигде ничего
+заводить не нужно.
+
+**Ноль рантайм-зависимостей.** Node 22.18+ / 24+ исполняет `.ts` напрямую
+(проверено на macOS и на проде playhub, Node 22.22.2) — сборки нет,
+в GitHub Actions ставить нечего.
+
+## Установка
+
+```bash
+npm install @mikitasazan/notify
+```
+
+Секрет один — `OPS_BOT_TOKEN`. Взять из vault (`vault get
+notify.OPS_BOT_TOKEN`) или из GitHub secrets репозитория.
+
+## Из TypeScript
+
+```ts
+import { notify } from '@mikitasazan/notify';
+
+await notify({
+  type: 'report',
+  project: 'playhub',
+  title: 'Сводка за день',
+  period: '26 июля',
+  lines: [['Игр в каталоге', 1284], ['Ошибок PM2', 3]]
+});
+```
+
+## Из bash (сервер, cron, ноутбук)
+
+```bash
+notify job --project playhub --job "Импорт игр" --status ok --stat "добавлено=5"
+trap 'notify job --project playhub --job "Импорт игр" --status fail --note "лог: $LOG"' ERR
+notify report --project playhub --json < payload.json   # весь объект со stdin
+```
+
+Код возврата **всегда 0** — уведомление не имеет права уронить вызвавший его
+процесс. Все ошибки — в stderr.
+
+## Из GitHub Actions
+
+```yaml
+- uses: mikitasazan/notify@v1.0.0   # версию пинит propagate
+  if: always()
+  with: { event: deploy, project: playhub, status: '${{ job.status }}' }
+  env:  { OPS_BOT_TOKEN: '${{ secrets.OPS_BOT_TOKEN }}' }
+```
+
+`status: ${{ job.status }}` (`success`/`failure`) автоматически маппится в
+`ok`/`fail` — не нужно двух шагов с `if: success()`/`if: failure()`.
+
+## Типы событий
+
+| Тип | Когда | Обязательные поля |
+|---|---|---|
+| `deploy` | выкатка кода | `project`, `status` |
+| `job` | регулярная задача (импорт, бэкап) | `project`, `job`, `status` |
+| `report` | сводка с цифрами | `project`, `title`, `lines` |
+| `ci` | итог CI на master | `project`, `status` |
+| `pr` | событие пул-реквеста | `project`, `action`, `number`, `title` |
+| `issue` | событие задачи | `project`, `action`, `number`, `title` |
+| `incident` | приложение сломалось прямо сейчас | `project`, `title` |
+| `heartbeat_miss` | задача не отметилась вовремя | `project`, `job` |
+
+Полные сигнатуры — `src/events.ts`.
+
+`--action` у `pr`: `opened`, `ready_for_review`, `review_requested`, `approved`,
+`changes_requested`, `merged`, `closed`. У `issue`: `opened`, `assigned`,
+`closed`. Принимаются и сырые имена GitHub (`reopened`,
+`review_request_removed`). Неизвестное действие — ошибка разбора, а не молчаливая
+подмена: иначе «запрошены правки» приехали бы как «открыт».
+
+**Но из GitHub в «⚙️ Ops» уходит не всё, что пакет умеет нарисовать.**
+`ready_for_review` и `review_requested` рендерятся (их можно послать вручную из
+CLI), однако общий workflow `.github/workflows/ops-notify.yml` их отбрасывает:
+оба сообщают про PR, который уже объявлен открытым, и открытие одного PR давало
+три карточки подряд. Правило владельца от 27.07.2026 — одна новость, одна
+карточка: **открыт → вердикт ревью (👍 / 📝) → закрыт или смёржен**. Белый список
+живёт в общем workflow, а не в подписках проектов, потому что подписка обязана
+лежать в вызывающем репозитории и в четырёх проектах расходится сама собой;
+политика же должна раскатываться одним тегом.
+
+## Новый проект
+
+1. В Telegram: создать группу, открыть её → «Изменить» → включить **«Темы»**,
+   добавить `@mikita_ops_bot` администратором с правом «Управление темами».
+   Это единственный ручной шаг — Telegram разрешает создавать группы только
+   живому аккаунту, ботом это не сделать.
+2. `notify setup <chat_id> maphub` — заведёт вкладки «⚙️ Ops» и «💬 Dev» и
+   напечатает готовую строку.
+3. Вставить строку в `src/routes.ts`.
+
+**Появились сотрудники на проекте** — просто добавь их в форум этого проекта.
+Ничего не мигрируется и не дублируется: они видят Ops и Dev своего проекта и
+не видят остальных.
+
+## Эволюция схемы событий
+
+Версии схемы нет и не будет. Сообщение живёт секунду и читается глазами —
+версионировать нечего. Вместо этого одно правило: **новое поле у
+существующего типа — только опциональное; обязательные поля не добавляются
+никогда, только новый тип события**. Тогда старый вызывающий код и новый
+пакет всегда совместимы.
+
+## Чего в пакете нет и почему
+
+- Очереди, брокера, демона — десятки сообщений в день, ретрай в памяти
+  процесса; доставка уведомления не стоит инфраструктуры, которую саму надо
+  мониторить.
+- Редактирования уже отправленных сообщений — требует хранить `message_id`,
+  то есть состояние и базу.
+- Автосоздания темы при первой отправке — сбой мог бы наплодить дублей;
+  создание — явная команда `notify setup`.
+- Любых зависимостей, сборки, MarkdownV2, мультиязычности, троттла (троттл —
+  забота вызывающего кода, он есть в `arvent/web/src/server/alert.ts` и там
+  и остаётся: работает только внутри долгоживущего процесса, а CLI стартует
+  заново на каждый вызов).
+
+## Разработка
+
+```bash
+npm run typecheck   # tsc --noEmit
+npm test            # node --test src/render.test.ts
+```
+
+## Release
+
+Один ритуал для всех общих пакетов (канон — скилл `package-ops`):
+
+```bash
+release patch|minor|major   # из этого каталога
+```
+
+Тесты → бамп + тег → публикация из клона тега → точная версия у всех
+потребителей с прогоном их собственных проверок, включая пин `uses:` в их
+workflow. `release` и `propagate` живут в `mac-config/home/bin/` и доступны из
+PATH. Карты потребителей нет: `propagate` находит их поиском по репозиториям.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,255 @@
+#!/usr/bin/env node
+/**
+ * `notify <type> [--flag value]...` — тонкий диспетчер. Ноль зависимостей:
+ * разбор аргументов написан руками (не yargs/commander), потому что здесь
+ * нужно ровно два вида флагов (одиночный и повторяемый `key=value`).
+ *
+ * Код возврата ВСЕГДА 0 — уведомление не имеет права уронить вызвавший его
+ * деплой или задачу. Все ошибки — только в stderr. Исключения намеренно нет
+ * (см. docs/rollout.md «чего не делаем»): сценария, где деплой должен упасть
+ * из-за неотправленного сообщения, не существует.
+ *
+ *   notify deploy   --project playhub --status ok --commit "msg" [--commit-url "..."] --url "..."
+ *   notify job      --project playhub --job "Импорт игр" --status ok --stat "добавлено=5"
+ *   notify report   --project playhub --title "Сводка за день" --line "Игр=1284"
+ *   notify ci       --project arvent  --status fail --branch master --actor saz_sam
+ *   notify pr       --project arvent  --action opened --number 142 --title "..."
+ *   notify incident --project arvent  --title "Redis недоступен" --detail "$ERR"
+ *   notify <type> --json < payload.json   # весь объект события со stdin
+ *   notify setup <chat_id форума> <ключ-проекта>   # создать вкладки, см. setup.ts
+ */
+import { readFileSync } from 'node:fs';
+import { notify } from "./send.js";
+import { setupTopic } from "./setup.js";
+const log = (msg) => console.error(`[notify] ${msg}`);
+const args = process.argv.slice(2);
+const command = args[0];
+if (command === 'setup') {
+    const [, chatId, projectKey] = args;
+    if (!chatId || !projectKey) {
+        log('использование: notify setup <chat_id форума> <ключ-проекта>');
+        log('  сначала создай группу, включи в ней «Темы» и добавь бота админом');
+        process.exit(0);
+    }
+    await setupTopic(chatId, projectKey);
+    process.exit(0);
+}
+const flags = new Map();
+const parseErrors = [];
+/** Флаги без значения. Всё остальное обязано его иметь. */
+const BOOLEAN_FLAGS = new Set(['json']);
+for (let i = 1; i < args.length; i++) {
+    const arg = args[i];
+    if (!arg.startsWith('--')) {
+        parseErrors.push(`лишний аргумент без флага: «${arg}»`);
+        continue;
+    }
+    // Форма `--key=value` обязательна для значений, начинающихся с `--`
+    // (текст ошибки, кусок диффа): иначе они были бы съедены как флаги.
+    const eq = arg.indexOf('=');
+    if (eq !== -1) {
+        const key = arg.slice(2, eq);
+        flags.set(key, [...(flags.get(key) ?? []), arg.slice(eq + 1)]);
+        continue;
+    }
+    const key = arg.slice(2);
+    if (BOOLEAN_FLAGS.has(key)) {
+        flags.set(key, ['true']);
+        continue;
+    }
+    const next = args[i + 1];
+    // Раньше флаг без значения молча становился строкой 'true'. Отсюда
+    // `--url` в конце команды давал `href="true"`, Telegram отвечал 400 и
+    // ТЕРЯЛОСЬ ВСЁ сообщение, а `--status` без значения рисовал 🔴 на
+    // успешном деплое. Теперь это явная ошибка разбора.
+    if (next === undefined || next.startsWith('--')) {
+        parseErrors.push(`флаг --${key} без значения`);
+        continue;
+    }
+    i++;
+    flags.set(key, [...(flags.get(key) ?? []), next]);
+}
+const one = (key) => flags.get(key)?.[0];
+// --item "текст" или --item "текст|https://ссылка"
+const items = () => (flags.get('item') ?? []).map((raw) => {
+    const idx = raw.lastIndexOf('|');
+    return idx === -1 ? { text: raw } : { text: raw.slice(0, idx), url: raw.slice(idx + 1) };
+});
+const pairs = (key) => (flags.get(key) ?? []).map((s) => {
+    const idx = s.indexOf('=');
+    return idx === -1 ? [s, ''] : [s.slice(0, idx), s.slice(idx + 1)];
+});
+const project = () => one('project');
+const PR_ALIASES = {
+    opened: 'opened',
+    reopened: 'opened',
+    ready_for_review: 'ready_for_review',
+    review_requested: 'review_requested',
+    review_request_removed: 'review_requested',
+    approved: 'approved',
+    changes_requested: 'changes_requested',
+    merged: 'merged',
+    closed: 'closed'
+};
+const ISSUE_ALIASES = {
+    opened: 'opened',
+    reopened: 'opened',
+    assigned: 'assigned',
+    closed: 'closed'
+};
+// Ошибка кладётся в parseErrors — тот же путь, что у остального разбора: ниже
+// он печатает все ошибки разом и выходит ДО отправки. Значение-заглушка нужно
+// только чтобы удовлетворить тип, до сети оно не доживёт.
+const prAction = (raw) => {
+    const hit = PR_ALIASES[(raw ?? '').toLowerCase()];
+    if (!hit) {
+        parseErrors.push(`--action: неизвестное действие PR «${raw ?? ''}» (${Object.keys(PR_ALIASES).join(', ')})`);
+        return 'opened';
+    }
+    return hit;
+};
+const issueAction = (raw) => {
+    const hit = ISSUE_ALIASES[(raw ?? '').toLowerCase()];
+    if (!hit) {
+        parseErrors.push(`--action: неизвестное действие задачи «${raw ?? ''}» (${Object.keys(ISSUE_ALIASES).join(', ')})`);
+        return 'opened';
+    }
+    return hit;
+};
+/**
+ * Всё, что не признано успехом, считается провалом.
+ *
+ * Тут важна не строгость, а согласованность: раньше `--status success`
+ * (естественная опечатка при ручном вызове) рисовал 🔴 «упал», но `severity()`
+ * видел «не fail» и слал сообщение БЕЗ звука. Красная плашка без звука —
+ * худший исход: авария выглядит аварией, но не будит.
+ */
+const status = () => {
+    const raw = (one('status') ?? '').toLowerCase();
+    return raw === 'ok' || raw === 'success' || raw === 'passed' || raw === '0' ? 'ok' : 'fail';
+};
+let event;
+if (flags.has('json')) {
+    try {
+        const payload = JSON.parse(readFileSync(0, 'utf-8'));
+        event = { type: command, ...payload };
+    }
+    catch (err) {
+        log(`не удалось разобрать --json со stdin: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+else {
+    switch (command) {
+        case 'deploy':
+            event = {
+                type: 'deploy',
+                project: project(),
+                status: status(),
+                commit: one('commit'),
+                commitUrl: one('commit-url'),
+                url: one('url'),
+                target: one('target'),
+                via: one('via')
+            };
+            break;
+        case 'job':
+            event = {
+                type: 'job',
+                project: project(),
+                job: one('job') ?? '(без имени)',
+                status: status(),
+                stats: pairs('stat'),
+                items: items(),
+                note: one('note'),
+                url: one('url')
+            };
+            break;
+        case 'report':
+            event = {
+                type: 'report',
+                project: project(),
+                title: one('title') ?? '(без заголовка)',
+                period: one('period'),
+                lines: pairs('line'),
+                items: items(),
+                url: one('url')
+            };
+            break;
+        case 'ci':
+            event = {
+                type: 'ci',
+                project: project(),
+                status: status(),
+                branch: one('branch'),
+                commit: one('commit'),
+                actor: one('actor'),
+                url: one('url')
+            };
+            break;
+        case 'pr':
+            event = {
+                type: 'pr',
+                project: project(),
+                action: prAction(one('action')),
+                number: Number(one('number')),
+                title: one('title') ?? '(без заголовка)',
+                author: one('author'),
+                reviewer: one('reviewer'),
+                url: one('url')
+            };
+            break;
+        case 'issue':
+            event = {
+                type: 'issue',
+                project: project(),
+                action: issueAction(one('action')),
+                number: Number(one('number')),
+                title: one('title') ?? '(без заголовка)',
+                author: one('author'),
+                assignee: one('assignee'),
+                url: one('url')
+            };
+            break;
+        case 'incident':
+            event = {
+                type: 'incident',
+                project: project(),
+                title: one('title') ?? '(без заголовка)',
+                detail: one('detail'),
+                url: one('url')
+            };
+            break;
+        case 'heartbeat_miss':
+            event = {
+                type: 'heartbeat_miss',
+                project: project(),
+                job: one('job') ?? '(без имени)',
+                lastSeen: one('last-seen'),
+                expected: one('expected')
+            };
+            break;
+        default:
+            log(`неизвестный тип события: ${command ?? '(не указан)'}`);
+    }
+}
+// Ошибки разбора — до отправки: лучше внятно сказать, что не так с командой,
+// чем прислать сообщение с «true» вместо ссылки или 🔴 на успешном деплое.
+if (parseErrors.length > 0) {
+    for (const err of parseErrors) {
+        log(err);
+    }
+    log('событие не отправлено — исправь команду');
+    process.exit(0);
+}
+if (event) {
+    // Ловим ВСЁ: уведомление не имеет права уронить деплой или крон, который
+    // его вызвал. В bash с `set -e` (или в `trap ... ERR`) ненулевой код здесь
+    // завалил бы саму задачу — ровно то, чего пакет обязан не делать.
+    try {
+        log(await notify(event));
+    }
+    catch (err) {
+        log(`не отправлено: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+process.exit(0);

package/dist/events.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Каталог событий — единственная точка входа для отправки. `notify()` (см.
+ * `send.ts`) принимает ТОЛЬКО значения этого типа: свободного текста в API
+ * нет, значит «своё» сообщение технически не написать.
+ *
+ * Правило эволюции схемы (версии нет и не будет — сообщение живёт секунду и
+ * читается глазами, версионировать нечего):
+ *   - новое поле у СУЩЕСТВУЮЩЕГО типа добавляется ТОЛЬКО опциональным;
+ *   - обязательные поля не добавляются никогда — только новый тип события.
+ * Тогда старый вызывающий код и новый пакет совместимы в обе стороны.
+ */
+export type Project = 'playhub' | 'one-q' | 'arvent' | 'game-publisher';
+/**
+ * Позиция списка внутри сообщения: задача из дайджеста, упавшая проверка,
+ * замечание. `url` необязателен — тогда рендерится просто строкой.
+ */
+export type Item = {
+    text: string;
+    url?: string;
+};
+export type NotifyEvent = 
+/** Выкатка кода на сервер. */
+{
+    type: 'deploy';
+    project: Project;
+    status: 'ok' | 'fail';
+    commit?: string;
+    /** Ссылка на коммит — строка «коммит» становится кликабельной. */
+    commitUrl?: string;
+    url?: string;
+    /**
+     * Куда выкатили. Заполнять ТОЛЬКО когда окружений больше одного: у сайтов
+     * с единственным продом «куда: прод» — строка, которую читают глазами и
+     * ничего из неё не узнают.
+     */
+    target?: string;
+    /**
+     * Откуда запустили: «вручную с Mac», «GitHub Actions». Вот это как раз
+     * новость — путей выкатки два, они дают разные последствия (ручной идёт
+     * с ноутбука и переменные берёт из локального .env), и по карточке видно,
+     * какой сработал.
+     */
+    via?: string;
+}
+/** Регулярная задача по расписанию: импорт игр, бэкап БД, валидатор. */
+ | {
+    type: 'job';
+    project: Project;
+    job: string;
+    status: 'ok' | 'fail';
+    stats?: Array<[label: string, value: string | number]>;
+    /** Детали: что именно упало, замечания прогона. */
+    items?: Item[];
+    note?: string;
+    url?: string;
+}
+/** Сводка с цифрами: дневной отчёт, дайджест аналитики. */
+ | {
+    type: 'report';
+    project: Project;
+    title: string;
+    period?: string;
+    lines: Array<[label: string, value: string | number]>;
+    /**
+     * Список позиций со ссылками — для дайджестов задач, где ценность в
+     * самих названиях, а не в цифре. Рендерятся отдельным блоком после
+     * `lines`.
+     */
+    items?: Item[];
+    url?: string;
+}
+/** Итог CI на основной ветке. */
+ | {
+    type: 'ci';
+    project: Project;
+    status: 'ok' | 'fail';
+    branch?: string;
+    commit?: string;
+    actor?: string;
+    url?: string;
+}
+/**
+ * Событие пул-реквеста. Виды покрывают весь путь PR, потому что владелец
+ * следит за работой команды по вкладке Ops, а не по почте: почта приходит
+ * только когда тебя позвали лично, и половина событий в неё не попадает.
+ */
+ | {
+    type: 'pr';
+    project: Project;
+    action: 'opened' | 'ready_for_review' | 'review_requested' | 'approved' | 'changes_requested' | 'merged' | 'closed';
+    number: number;
+    title: string;
+    author?: string;
+    reviewer?: string;
+    url?: string;
+}
+/** Событие задачи: заведена, взята в работу, закрыта. */
+ | {
+    type: 'issue';
+    project: Project;
+    action: 'opened' | 'assigned' | 'closed';
+    number: number;
+    title: string;
+    author?: string;
+    assignee?: string;
+    url?: string;
+}
+/** Приложение сломалось прямо сейчас (рантайм-алерт). */
+ | {
+    type: 'incident';
+    project: Project;
+    title: string;
+    detail?: string;
+    url?: string;
+}
+/** Задача не отметилась вовремя — сторож молчания (heartbeat). */
+ | {
+    type: 'heartbeat_miss';
+    project: Project;
+    job: string;
+    lastSeen?: string;
+    expected?: string;
+};
+export type EventType = NotifyEvent['type'];
+/** Красное = со звуком и с дублем в тему инцидентов. Всё остальное — тихо. */
+export declare const severity: (e: NotifyEvent) => "info" | "error";

package/dist/events.js

@@ -0,0 +1,21 @@
+/**
+ * Каталог событий — единственная точка входа для отправки. `notify()` (см.
+ * `send.ts`) принимает ТОЛЬКО значения этого типа: свободного текста в API
+ * нет, значит «своё» сообщение технически не написать.
+ *
+ * Правило эволюции схемы (версии нет и не будет — сообщение живёт секунду и
+ * читается глазами, версионировать нечего):
+ *   - новое поле у СУЩЕСТВУЮЩЕГО типа добавляется ТОЛЬКО опциональным;
+ *   - обязательные поля не добавляются никогда — только новый тип события.
+ * Тогда старый вызывающий код и новый пакет совместимы в обе стороны.
+ */
+/** Красное = со звуком и с дублем в тему инцидентов. Всё остальное — тихо. */
+export const severity = (e) => {
+    if (e.type === 'incident' || e.type === 'heartbeat_miss') {
+        return 'error';
+    }
+    if ('status' in e && e.status === 'fail') {
+        return 'error';
+    }
+    return 'info';
+};

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export type { EventType, NotifyEvent, Project } from './events.ts';
+export { severity } from './events.ts';
+export { notify, sendReport } from './send.ts';
+export type { SendResult } from './send.ts';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { severity } from "./events.js";
+export { notify, sendReport } from "./send.js";

package/dist/render.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Один рендерер на тип события, все по одному каркасу:
+ *
+ *   эмодзи Заголовок · проект
+ *   ключ: значение
+ *   ключ: значение
+ *   <a href="…">Ссылка</a>
+ *
+ * Проект указывается ВСЕГДА, даже в теме самого проекта — в теме
+ * `🔴 incidents` сообщения четырёх проектов лежат вперемешку, и формат
+ * должен быть один и тот же независимо от того, куда сообщение попало.
+ */
+import type { NotifyEvent } from './events.ts';
+/** Экранируется ВСЁ, что пришло снаружи — теги ставит только шаблон. */
+export declare const esc: (v: unknown) => string;
+/**
+ * Telegram режет сообщение на 4096 символах — режем сами, по возможности по
+ * границе строки.
+ *
+ * Два подвоха, оба приводили к ТИХОЙ потере сообщения:
+ * 1. Резать строго по последнему `\n` нельзя: если длинный кусок идёт одной
+ *    строкой (стектрейс, вывод команды — самый частый `detail` у инцидента),
+ *    последний перевод строки стоит ПЕРЕД ним, и содержимое выбрасывалось
+ *    целиком — приходил заголовок без единого факта о поломке.
+ * 2. Резать посреди HTML-тега или сущности тоже нельзя: Telegram отвечает
+ *    `400 can't parse entities`, а 4xx мы считаем постоянной ошибкой и не
+ *    повторяем — сообщение исчезало совсем.
+ */
+export declare const clampMessage: (text: string, limit?: number) => string;
+/** Рендерит событие в готовый HTML-текст, обрезанный под лимит Telegram. */
+export declare const render: (e: NotifyEvent) => string;

package/dist/render.js

@@ -0,0 +1,174 @@
+/** Экранируется ВСЁ, что пришло снаружи — теги ставит только шаблон. */
+export const esc = (v) => String(v ?? '')
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;');
+/**
+ * Telegram режет сообщение на 4096 символах — режем сами, по возможности по
+ * границе строки.
+ *
+ * Два подвоха, оба приводили к ТИХОЙ потере сообщения:
+ * 1. Резать строго по последнему `\n` нельзя: если длинный кусок идёт одной
+ *    строкой (стектрейс, вывод команды — самый частый `detail` у инцидента),
+ *    последний перевод строки стоит ПЕРЕД ним, и содержимое выбрасывалось
+ *    целиком — приходил заголовок без единого факта о поломке.
+ * 2. Резать посреди HTML-тега или сущности тоже нельзя: Telegram отвечает
+ *    `400 can't parse entities`, а 4xx мы считаем постоянной ошибкой и не
+ *    повторяем — сообщение исчезало совсем.
+ */
+export const clampMessage = (text, limit = 4000) => {
+    if (text.length <= limit) {
+        return text;
+    }
+    const cut = text.slice(0, limit);
+    const lastBreak = cut.lastIndexOf('\n');
+    // По границе строки — только если так остаётся большая часть содержимого.
+    let end = lastBreak > limit * 0.6 ? lastBreak : limit;
+    // Не обрываемся внутри `<...>` и внутри `&...;` — иначе разметка ломается.
+    const openTag = cut.lastIndexOf('<', end - 1);
+    if (openTag !== -1 && cut.indexOf('>', openTag) === -1) {
+        end = openTag;
+    }
+    const amp = cut.lastIndexOf('&', end - 1);
+    if (amp !== -1 && end - amp <= 10 && cut.indexOf(';', amp) === -1) {
+        end = amp;
+    }
+    const body = cut.slice(0, end);
+    // Кламп мог отрезать закрывающие теги — добираем их, чтобы разметка сошлась.
+    const tail = ['b', 'a', 'i', 'code']
+        .filter((t) => {
+        const opened = (body.match(new RegExp(`<${t}[ >]`, 'g')) ?? []).length;
+        const closed = (body.match(new RegExp(`</${t}>`, 'g')) ?? []).length;
+        return opened > closed;
+    })
+        .map((t) => `</${t}>`)
+        .join('');
+    return `${body}${tail}\n…`;
+};
+const header = (icon, title, project) => `${icon} <b>${esc(title)}</b> · ${esc(project)}`;
+// Значение — жирным: канон формата (bot-message-formatting-canon) — иконка-лид,
+// факты построчно, значения выделены; метка остаётся обычной, чтобы глаз
+// цеплялся за содержимое, а не за служебное слово.
+const kv = (label, value) => value === undefined || value === '' ? null : `${esc(label)}: <b>${esc(value)}</b>`;
+const link = (url, label) => url ? `<a href="${esc(url)}">${esc(label)}</a>` : null;
+const join = (parts) => parts.filter((p) => p !== null).join('\n');
+/** Список позиций — общий для `job` и `report`, чтобы они не разъехались. */
+const bullets = (items) => (items ?? []).map((it) => (it.url ? `• <a href="${esc(it.url)}">${esc(it.text)}</a>` : `• ${esc(it.text)}`));
+const renderDeploy = (e) => {
+    const icon = e.status === 'ok' ? '✅' : '🔴';
+    const title = e.status === 'ok' ? 'Деплой завершён' : 'Деплой упал';
+    // Коммит со ссылкой — кликабельная строка вместо голого текста; жалоба
+    // владельца на некликабельные дайджесты распространяется и сюда.
+    const commitLine = e.commit
+        ? e.commitUrl
+            ? `коммит: <a href="${esc(e.commitUrl)}"><b>${esc(e.commit)}</b></a>`
+            : kv('коммит', e.commit)
+        : null;
+    return join([
+        header(icon, title, e.project),
+        commitLine,
+        kv('откуда', e.via),
+        kv('куда', e.target),
+        link(e.url, 'Открыть логи')
+    ]);
+};
+const renderJob = (e) => {
+    const icon = e.status === 'ok' ? '✅' : '🔴';
+    const items = bullets(e.items);
+    return join([
+        header(icon, e.job, e.project),
+        ...(e.stats ?? []).map(([label, value]) => kv(label, value)),
+        items.length > 0 ? '' : null,
+        ...items,
+        kv('примечание', e.note),
+        link(e.url, 'Подробнее')
+    ]);
+};
+const renderReport = (e) => {
+    const items = bullets(e.items);
+    return join([
+        header('📊', e.title, e.project),
+        e.period ? esc(e.period) : null,
+        e.period ? '' : null,
+        ...e.lines.map(([label, value]) => kv(label, value)),
+        items.length > 0 ? '' : null,
+        ...items,
+        link(e.url, 'Открыть отчёт')
+    ]);
+};
+const renderCi = (e) => {
+    const icon = e.status === 'ok' ? '✅' : '🔴';
+    const title = e.status === 'ok' ? 'CI зелёный' : 'CI упал';
+    return join([
+        header(icon, title, e.project),
+        kv('ветка', e.branch),
+        kv('коммит', e.commit),
+        kv('автор', e.actor),
+        link(e.url, 'Открыть логи')
+    ]);
+};
+// Значок у каждого вида свой: в ленте Ops событие узнаётся по нему до чтения
+// текста. Дублировать значок между видами нельзя — легенда закреплена в теме
+// и обещает однозначность.
+const PR_TITLES = {
+    opened: { icon: '🔀', verb: 'открыт' },
+    ready_for_review: { icon: '📤', verb: 'готов к ревью' },
+    review_requested: { icon: '👁', verb: 'ждёт ревью' },
+    approved: { icon: '👍', verb: 'ревью пройдено' },
+    changes_requested: { icon: '📝', verb: 'запрошены правки' },
+    merged: { icon: '✅', verb: 'смёржен' },
+    closed: { icon: '⛔', verb: 'закрыт без слияния' }
+};
+const ISSUE_TITLES = {
+    opened: { icon: '🆕', verb: 'заведена' },
+    assigned: { icon: '🙋', verb: 'взята в работу' },
+    closed: { icon: '☑️', verb: 'закрыта' }
+};
+const renderPr = (e) => {
+    const { icon, verb } = PR_TITLES[e.action];
+    return join([
+        header(icon, `PR #${e.number} ${verb}`, e.project),
+        esc(e.title),
+        kv('автор', e.author),
+        kv('ревьюер', e.reviewer),
+        link(e.url, 'Открыть PR')
+    ]);
+};
+const renderIssue = (e) => {
+    const { icon, verb } = ISSUE_TITLES[e.action];
+    return join([
+        header(icon, `Задача #${e.number} ${verb}`, e.project),
+        esc(e.title),
+        kv('автор', e.author),
+        kv('исполнитель', e.assignee),
+        link(e.url, 'Открыть задачу')
+    ]);
+};
+const renderIncident = (e) => join([header('🚨', 'Инцидент', e.project), esc(e.title), e.detail ? esc(e.detail) : null, link(e.url, 'Подробнее')]);
+const renderHeartbeatMiss = (e) => join([
+    header('🔴', `Не отметилась: ${e.job}`, e.project),
+    kv('последний раз', e.lastSeen),
+    kv('ожидалось', e.expected)
+]);
+const RENDERERS = {
+    deploy: renderDeploy,
+    job: renderJob,
+    report: renderReport,
+    ci: renderCi,
+    pr: renderPr,
+    issue: renderIssue,
+    incident: renderIncident,
+    heartbeat_miss: renderHeartbeatMiss
+};
+/** Рендерит событие в готовый HTML-текст, обрезанный под лимит Telegram. */
+export const render = (e) => {
+    const renderer = RENDERERS[e.type];
+    // Прикрывает путь `--json` и вызовы из JS без типов: там `type` — обычная
+    // строка, и неизвестное значение роняло процесс через `renderer is not a
+    // function`. Падать из-за уведомления нельзя.
+    if (typeof renderer !== 'function') {
+        throw new Error(`неизвестный тип события: ${String(e.type)}`);
+    }
+    return clampMessage(renderer(e));
+};

package/dist/routes.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Маршрутизация «событие → куда слать». ЕДИНСТВЕННОЕ место, которое трогает
+ * новый проект: добавить строку в `ROUTES` — ни нового бота, ни нового
+ * секрета, ни правок в проектах.
+ *
+ * Схема: ФОРУМ НА ПРОЕКТ, внутри вкладки «⚙️ Ops» (уведомления роботов) и
+ * «💬 Dev» (живой чат людей).
+ *
+ * Почему не один общий форум с темой на проект — так было в первой редакции
+ * и это оказалось ошибкой: Telegram не умеет закрывать отдельную тему от
+ * участника, кто в группе — видит ВСЕ вкладки. Значит сотрудников туда не
+ * пустить, им нужен свой чат, и один проект начинает жить в двух местах
+ * сразу («тема у владельца» + «канал у команды»). Форум на проект убирает
+ * дублирование: сотрудник добавляется в форум своего проекта и чужих не
+ * видит, а схема одна для всех — появились люди на новом проекте, просто
+ * добавь их туда же.
+ *
+ * Id чатов и тем — не секрет: без токена бота они бесполезны. Поэтому живут
+ * в коде, а не в переменных окружения (иначе «добавить проект» = правка в
+ * трёх местах). Секрет ровно один — `OPS_BOT_TOKEN`.
+ */
+import type { NotifyEvent, Project } from './events.ts';
+type Forum = {
+    /** Id форума-супергруппы проекта. */
+    chat: string;
+    /** Вкладка «⚙️ Ops» — сюда пишут роботы. */
+    ops: number;
+    /** Вкладка «💬 Dev» — люди. Бот сюда не пишет; поле держим для полноты. */
+    dev: number;
+};
+export declare const ROUTES: Record<Project, Forum>;
+export type Target = {
+    chat: string;
+    thread?: number;
+    silent: boolean;
+};
+/**
+ * Куда уходит событие. Всё — во вкладку «Ops» своего проекта; красное
+ * приходит туда же, но со звуком.
+ *
+ * Отдельной темы «инциденты» больше нет: она имела смысл, пока форум был
+ * общий на все проекты. Теперь у каждого проекта своя группа, и авария
+ * видна в его же ленте — сводить их в одно место незачем, а звук и так
+ * отличает аварию от рядового сообщения.
+ */
+export declare const targets: (e: NotifyEvent) => Target[];
+export {};

package/dist/routes.js

@@ -0,0 +1,30 @@
+import { severity } from "./events.js";
+export const ROUTES = {
+    // ops/dev = 22/23, а не 3/4: старые вкладки удалили вручную 27.07.2026, и
+    // вместе с темой Telegram сносит её сообщения. Пересозданная тема получает
+    // НОВЫЙ id — id темы это id её первого сообщения, он не переиспользуется.
+    arvent: { chat: '-1004299939100', ops: 22, dev: 23 },
+    playhub: { chat: '-1004418379613', ops: 3, dev: 4 },
+    'game-publisher': { chat: '-1004292453693', ops: 3, dev: 4 },
+    'one-q': { chat: '-1004466909784', ops: 3, dev: 4 }
+};
+/**
+ * Куда уходит событие. Всё — во вкладку «Ops» своего проекта; красное
+ * приходит туда же, но со звуком.
+ *
+ * Отдельной темы «инциденты» больше нет: она имела смысл, пока форум был
+ * общий на все проекты. Теперь у каждого проекта своя группа, и авария
+ * видна в его же ленте — сводить их в одно место незачем, а звук и так
+ * отличает аварию от рядового сообщения.
+ */
+export const targets = (e) => {
+    const forum = ROUTES[e.project];
+    // Неизвестный проект — опечатка в `--project` или проект, забытый в ROUTES.
+    // Возвращаем пустой список, а не падаем: уведомление не имеет права уронить
+    // вызвавший его деплой или крон (в bash с `set -e` падение было бы фатальным).
+    if (!forum) {
+        console.error(`[notify] неизвестный проект «${e.project}» — известны: ${Object.keys(ROUTES).join(', ')}`);
+        return [];
+    }
+    return [{ chat: forum.chat, thread: forum.ops, silent: severity(e) === 'info' }];
+};

package/dist/send.d.ts

@@ -0,0 +1,26 @@
+import type { NotifyEvent, Project } from './events.ts';
+export type SendResult = 'sent' | 'skipped' | 'failed';
+/**
+ * Отправляет событие во все его цели (тема проекта + при необходимости
+ * `incidents` + чат команды). Цели идут последовательно; провал одной не
+ * отменяет остальные. `'sent'`, если хотя бы одна цель получила сообщение.
+ */
+export declare const notify: (e: NotifyEvent) => Promise<SendResult>;
+/**
+ * Готовый HTML во вкладку «Ops» проекта — ТОЛЬКО для дневных отчётов.
+ *
+ * Зачем исключение из правила «свободного текста в API нет». Отчёт — это не
+ * событие: в нём плотная строка вроде
+ * `🎮 1284 игр (🍎 412 iOS +3 · 🤖 890 Android +5) | 📈 +240 запусков`,
+ * и разложить её в `label=value` можно только испортив. Но транспорт у отчёта
+ * ТОТ ЖЕ: ретраи, 429, таймауты, curl-фолбэк, номер вкладки. Пока его копировали
+ * в каждый скрипт, один и тот же баг с дублями на таймауте пришлось чинить
+ * дважды — в пакете и в game-publisher (27.07.2026).
+ *
+ * Граница: формат событий по-прежнему задаёт только пакет, «своё» уведомление
+ * о деплое или упавшей задаче написать нельзя. Здесь стандартизирован транспорт,
+ * а не формат — и в этом весь смысл.
+ *
+ * Всегда беззвучно: отчёт читают утром, а не по звонку.
+ */
+export declare const sendReport: (project: Project, html: string) => Promise<SendResult>;

package/dist/send.js

@@ -0,0 +1,177 @@
+/**
+ * Транспорт. Переносит проверенный на проде код из
+ * game-publisher/scripts/lib/telegram.ts (fetch → curl-фолбэк через stdin,
+ * `.trim()` токена) и добавляет то, чего там не было: несколько целей за
+ * вызов, `message_thread_id`, повтор на HTTP 429 с уважением `retry_after`,
+ * повтор на 5xx, отказ без повтора на прочих 4xx.
+ *
+ * Токен — ТОЛЬКО из `process.env.OPS_BOT_TOKEN`, с `.trim()`: перевод
+ * строки в токене (частая находка при копипасте) заставляет curl разобрать
+ * конфиг как две директивы и утащить хвост токена в stderr прогона.
+ *
+ * Нет токена → 'skipped', не исключение: уведомление не имеет права уронить
+ * деплой или регулярную задачу, которая его вызвала.
+ */
+import { execFileSync } from 'node:child_process';
+import { clampMessage, render } from "./render.js";
+import { ROUTES, targets } from "./routes.js";
+const log = (msg) => {
+    // stderr, не stdout — stdout зарезервирован под возможный машинный вывод CLI.
+    console.error(`[notify] ${msg}`);
+};
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const buildBody = (target, text) => JSON.stringify({
+    chat_id: target.chat,
+    ...(target.thread ? { message_thread_id: target.thread } : {}),
+    text,
+    parse_mode: 'HTML',
+    disable_web_page_preview: true,
+    disable_notification: target.silent
+});
+/**
+ * Запасной путь: curl — другой стек TLS/DNS, выручает там, где fetch/undici
+ * не маршрутизирует. URL с токеном уходит файлом конфига через stdin, а не
+ * аргументом: в argv его видно любому пользователю сервера через `ps aux`.
+ * stderr — в 'pipe', а не наследуется: сообщение об ошибке curl может
+ * содержать кусок URL с токеном, в лог прогона он попадать не должен.
+ */
+const sendViaCurl = (token, target, text) => {
+    const config = [
+        `url = "https://api.telegram.org/bot${token}/sendMessage"`,
+        'request = "POST"',
+        'header = "Content-Type: application/json"',
+        `data = ${JSON.stringify(buildBody(target, text))}`,
+        'max-time = 15',
+        'silent',
+        'fail'
+    ].join('\n');
+    try {
+        execFileSync('curl', ['--config', '-'], {
+            input: config,
+            stdio: ['pipe', 'pipe', 'pipe']
+        });
+        return 'ok';
+    }
+    catch (err) {
+        // 28 — собственный таймаут curl (`max-time` выше). Как и таймаут fetch, он
+        // означает «ответа нет», а не «не доставлено»: повтор положил бы в чат
+        // вторую копию. Всё остальное (отказ соединения, 4xx с `fail`) повторить
+        // безопасно.
+        return err.status === 28 ? 'fail' : 'retry';
+    }
+};
+const attempt = async (token, target, text) => {
+    try {
+        const res = await fetch(`https://api.telegram.org/bot${token}/sendMessage`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: buildBody(target, text),
+            signal: AbortSignal.timeout(10_000)
+        });
+        if (res.ok) {
+            return { outcome: 'ok' };
+        }
+        if (res.status === 429) {
+            const body = (await res.json().catch(() => null));
+            const retryAfter = typeof body?.parameters?.retry_after === 'number' ? body.parameters.retry_after : 5;
+            return { outcome: 'retry', waitMs: Math.min(retryAfter, 60) * 1000 };
+        }
+        if (res.status >= 500) {
+            return { outcome: 'retry', waitMs: 1000 };
+        }
+        // 4xx кроме 429 — постоянная ошибка (не тот thread, бот не админ,
+        // неверный chat_id). Повтор её не исправит.
+        //
+        // Причину обязательно вытаскиваем: Telegram кладёт её в `description`
+        // («message thread not found», «can't parse entities»), и без неё понять,
+        // почему уведомления пропали, невозможно — а разбираться будет не
+        // разработчик, а владелец.
+        const detail = (await res.json().catch(() => null));
+        log(`HTTP ${res.status}: ${detail?.description ?? 'без описания'} — не повторяем, ошибка постоянная`);
+        return { outcome: 'fail' };
+    }
+    catch (err) {
+        // Таймаут — НЕ то же самое, что «не доставлено»: запрос мог дойти, а ответ
+        // не успеть вернуться. Повтор (хоть curl-ом, хоть следующей попыткой) кладёт
+        // в чат второй экземпляр того же сообщения — дедупа у Bot API нет. Поэтому
+        // на таймауте останавливаемся и честно пишем 'failed': лишняя копия аварии
+        // хуже, чем пропущенная строка в логе, а сообщение, скорее всего, ушло.
+        if (err instanceof Error && err.name === 'TimeoutError') {
+            log('таймаут ответа — не повторяем: сообщение могло уже уйти');
+            return { outcome: 'fail' };
+        }
+        // Сюда попадают отказы соединения (DNS, TLS, сеть недоступна) — запрос не
+        // ушёл, дубля быть не может, фолбэк безопасен.
+        log('fetch не прошёл, пробуем curl…');
+        const curl = sendViaCurl(token, target, text);
+        return curl === 'retry' ? { outcome: 'retry', waitMs: 1000 } : { outcome: curl };
+    }
+};
+const MAX_ATTEMPTS = 3;
+const sendOne = async (token, target, text) => {
+    let waitMs = 0;
+    for (let i = 0; i < MAX_ATTEMPTS; i++) {
+        if (waitMs > 0) {
+            await sleep(waitMs);
+        }
+        const result = await attempt(token, target, text);
+        if (result.outcome === 'ok') {
+            return 'sent';
+        }
+        if (result.outcome === 'fail') {
+            return 'failed';
+        }
+        waitMs = result.waitMs;
+    }
+    log('исчерпаны попытки отправки');
+    return 'failed';
+};
+/** Общий хвост для `notify` и `sendReport`: токен, цели, последовательная отправка. */
+const deliver = async (where, text) => {
+    const token = process.env.OPS_BOT_TOKEN?.trim();
+    if (!token) {
+        log('нет OPS_BOT_TOKEN — сообщение не отправлено');
+        return 'skipped';
+    }
+    if (where.length === 0) {
+        return 'skipped';
+    }
+    const results = [];
+    // Последовательно, не Promise.all: провал одной цели не должен гонять
+    // ретраи параллельно с остальными и колотить API по нескольким чатам разом.
+    for (const target of where) {
+        results.push(await sendOne(token, target, text));
+    }
+    return results.includes('sent') ? 'sent' : 'failed';
+};
+/**
+ * Отправляет событие во все его цели (тема проекта + при необходимости
+ * `incidents` + чат команды). Цели идут последовательно; провал одной не
+ * отменяет остальные. `'sent'`, если хотя бы одна цель получила сообщение.
+ */
+export const notify = async (e) => deliver(targets(e), render(e));
+/**
+ * Готовый HTML во вкладку «Ops» проекта — ТОЛЬКО для дневных отчётов.
+ *
+ * Зачем исключение из правила «свободного текста в API нет». Отчёт — это не
+ * событие: в нём плотная строка вроде
+ * `🎮 1284 игр (🍎 412 iOS +3 · 🤖 890 Android +5) | 📈 +240 запусков`,
+ * и разложить её в `label=value` можно только испортив. Но транспорт у отчёта
+ * ТОТ ЖЕ: ретраи, 429, таймауты, curl-фолбэк, номер вкладки. Пока его копировали
+ * в каждый скрипт, один и тот же баг с дублями на таймауте пришлось чинить
+ * дважды — в пакете и в game-publisher (27.07.2026).
+ *
+ * Граница: формат событий по-прежнему задаёт только пакет, «своё» уведомление
+ * о деплое или упавшей задаче написать нельзя. Здесь стандартизирован транспорт,
+ * а не формат — и в этом весь смысл.
+ *
+ * Всегда беззвучно: отчёт читают утром, а не по звонку.
+ */
+export const sendReport = async (project, html) => {
+    const forum = ROUTES[project];
+    if (!forum) {
+        log(`неизвестный проект «${project}» — отчёт не отправлен`);
+        return 'skipped';
+    }
+    return deliver([{ chat: forum.chat, thread: forum.ops, silent: true }], clampMessage(html));
+};

package/dist/setup.d.ts

@@ -0,0 +1 @@
+export declare const setupTopic: (chatId: string, projectKey: string) => Promise<void>;

package/dist/setup.js

@@ -0,0 +1,45 @@
+/**
+ * `notify setup "<Название проекта>"` — заводит вкладки «⚙️ Ops» и «💬 Dev»
+ * в уже созданном форуме и печатает готовую строку для `ROUTES`.
+ *
+ * Сам форум-супергруппу бот создать не может — Telegram разрешает это только
+ * живому аккаунту. Поэтому порядок для нового проекта такой:
+ *   1. создать группу в Telegram, включить в ней «Темы», добавить
+ *      @mikita_ops_bot администратором с правом «Управление темами»;
+ *   2. `notify setup <chat_id>` — заведёт обе вкладки и напечатает строку;
+ *   3. вставить строку в `src/routes.ts`.
+ *
+ * Шаг 1 делается один раз на проект и занимает полминуты; шаги 2–3 —
+ * механические.
+ */
+const log = (msg) => console.error(`[notify] ${msg}`);
+const createTopic = async (token, chat, name, color) => {
+    const res = await fetch(`https://api.telegram.org/bot${token}/createForumTopic`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ chat_id: chat, name, icon_color: color }),
+        signal: AbortSignal.timeout(10_000)
+    });
+    const body = (await res.json());
+    if (!body.ok || !body.result) {
+        log(`не удалось создать «${name}»: ${body.description ?? `HTTP ${res.status}`}`);
+        return null;
+    }
+    return body.result.message_thread_id;
+};
+export const setupTopic = async (chatId, projectKey) => {
+    const token = process.env.OPS_BOT_TOKEN?.trim();
+    if (!token) {
+        log('нет OPS_BOT_TOKEN — не могу создать вкладки');
+        return;
+    }
+    const ops = await createTopic(token, chatId, '⚙️ Ops', 9367192);
+    const dev = await createTopic(token, chatId, '💬 Dev', 7322096);
+    if (ops === null || dev === null) {
+        log('проверь: бот админ группы с правом «Управление темами», а темы в группе включены?');
+        return;
+    }
+    log(`вкладки созданы: Ops=${ops}, Dev=${dev}`);
+    log('добавь в src/routes.ts:');
+    log(`  ${JSON.stringify(projectKey)}: { chat: '${chatId}', ops: ${ops}, dev: ${dev} },`);
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@mikitasazan/notify",
+  "version": "1.0.0",
+  "description": "Единая типизированная отправка Telegram-уведомлений (форум-темы, маршрутизация, ретраи) для всех проектов",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mikitasazan/notify.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mikitasazan/notify/issues"
+  },
+  "homepage": "https://github.com/mikitasazan/notify#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.18"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": "./dist/index.js",
+    "./cli": "./dist/cli.js"
+  },
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "notify": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepare": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "node --test src/*.test.ts"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.3",
+    "typescript": "^5.9.3"
+  }
+}