@mikitasazan/notify 1.8.0 → 1.9.0

package/dist/routes.d.ts

@@ -1,34 +1,37 @@
 /**
- * Маршрутизация «событие → куда слать». ЕДИНСТВЕННОЕ место, которое трогает
- * новый проект: добавить строку в `ROUTES` — ни нового бота, ни нового
- * секрета, ни правок в проектах.
+ * Routing "event → where to send." The ONLY place that a new project
+ * touches: add a row to `ROUTES` — no new bot, no new secret, no edits in
+ * the projects themselves.
  *
- * Схема: ФОРУМ НА ПРОЕКТ, внутри вкладки «⚙️ Ops» (уведомления роботов) и
- * «💬 Dev» (живой чат людей).
+ * The scheme: ONE FORUM PER PROJECT, with an "⚙️ Ops" tab (robot
+ * notifications) and a "💬 Dev" tab (people's live chat) inside it.
  *
- * Почему не один общий форум с темой на проект — так было в первой редакции
- * и это оказалось ошибкой: Telegram не умеет закрывать отдельную тему от
- * участника, кто в группе — видит ВСЕ вкладки. Значит сотрудников туда не
- * пустить, им нужен свой чат, и один проект начинает жить в двух местах
- * сразу («тема у владельца» + «канал у команды»). Форум на проект убирает
- * дублирование: сотрудник добавляется в форум своего проекта и чужих не
- * видит, а схема одна для всех — появились люди на новом проекте, просто
- * добавь их туда же.
+ * Why not one shared forum with a topic per project — that was the first
+ * version, and it turned out to be a mistake: Telegram cannot hide one
+ * topic from a member — whoever is in the group sees ALL the tabs. That
+ * means employees cannot be let in, they need their own chat, and one
+ * project ends up living in two places at once ("the owner's topic" +
+ * "the team's channel"). A forum per project removes the duplication: an
+ * employee is added to their own project's forum and does not see anyone
+ * else's, and the scheme is the same for everyone — people show up on a
+ * new project, just add them to the same forum.
  *
- * Id чатов и тем — не секрет: без токена бота они бесполезны. Поэтому живут
- * в коде, а не в переменных окружения (иначе «добавить проект» = правка в
- * трёх местах). Секрет ровно один — `OPS_BOT_TOKEN`.
+ * Chat and topic ids are not a secret: without the bot's token they are
+ * useless. So they live in code, not in environment variables (otherwise
+ * "add a project" means edits in three places). There is exactly one
+ * secret — `OPS_BOT_TOKEN`.
  */
 import type { NotifyEvent, Project } from './events.ts';
 type Forum = {
-    /** Id форума-супергруппы проекта. */
+    /** The id of the project's forum supergroup. */
     chat: string;
-    /** Вкладка «⚙️ Ops» — сюда пишут роботы. */
+    /** The "⚙️ Ops" tab — robots write here. */
     ops: number;
     /**
-     * Вкладка «💬 Dev» — люди. Бот сюда не пишет; поле держим для полноты.
-     * Необязательное: у инфраструктурного форума людей нет и обсуждать нечего,
-     * а пустая вкладка читается как забытая настройка, а не как задел.
+     * The "💬 Dev" tab — people. The bot does not write here; the field is
+     * kept for completeness. Optional: an infrastructure forum has no people
+     * and nothing to discuss, and an empty tab would read as a forgotten
+     * setting, not as room to grow into.
      */
     dev?: number;
 };
@@ -39,13 +42,14 @@ export type Target = {
     silent: boolean;
 };
 /**
- * Куда уходит событие. Всё — во вкладку «Ops» своего проекта; красное
- * приходит туда же, но со звуком.
+ * Where an event goes. Everything goes to its own project's "Ops" tab; a
+ * red one arrives there too, just with sound.
  *
- * Отдельной темы «инциденты» больше нет: она имела смысл, пока форум был
- * общий на все проекты. Теперь у каждого проекта своя группа, и авария
- * видна в его же ленте — сводить их в одно место незачем, а звук и так
- * отличает аварию от рядового сообщения.
+ * There is no separate "incidents" topic any more: it made sense while the
+ * forum was shared across all projects. Now every project has its own
+ * group, and an incident is visible in that same feed — there is no reason
+ * to funnel them into one place, and the sound already tells an incident
+ * apart from an ordinary message.
  */
 export declare const targets: (e: NotifyEvent) => Target[];
 export {};

package/dist/routes.js

@@ -1,38 +1,43 @@
 import { severity } from "./events.js";
 export const ROUTES = {
-    // ops/dev = 22/23, а не 3/4: старые вкладки удалили вручную 27.07.2026, и
-    // вместе с темой Telegram сносит её сообщения. Пересозданная тема получает
-    // НОВЫЙ id — id темы это id её первого сообщения, он не переиспользуется.
+    // ops/dev = 22/23, not 3/4: the old tabs were deleted by hand on
+    // 27.07.2026, and Telegram removes a topic's messages along with it. A
+    // recreated topic gets a NEW id — a topic's id is the id of its first
+    // message, it is never reused.
     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 },
-    // Без `dev`: сейф — инфраструктура, обсуждать в нём некому. Только отчёты
-    // еженедельной проверки, и то лишь когда что-то сломалось.
+    // No `dev`: the safe is infrastructure, there is no one to discuss it
+    // with. Only reports from the weekly check, and only when something
+    // broke.
     vault: { chat: '-1004459314999', ops: 3 },
-    // Тоже инфраструктура, без `dev`: дневной дайджест задач и понедельничная
-    // сводка спотыканий. До этой строки оба тихо умирали на «неизвестный проект».
+    // Also infrastructure, no `dev`: the daily task digest and the Monday
+    // stumbles summary. Before this row, both used to die silently on
+    // "unknown project."
     'mac-config': { chat: '-1004442522004', ops: 2 },
-    // Корпоративный проект владельца: только его собственные отчёты «что дала
-    // выливка» (ali98x-sentry). Без `dev` — команда проекта живёт в чужих
-    // системах, людей здесь нет. До 18.08.2026 отчёты терялись на «неизвестный
-    // проект» неделями.
+    // The owner's corporate project: only its own reports on "what the
+    // publish delivered" (ali98x-sentry). No `dev` — the project's team lives
+    // in other systems, there are no people here. Until 18.08.2026 reports
+    // were getting lost on "unknown project" for weeks.
     alitools: { chat: '-1003904331479', ops: 3 }
 };
 /**
- * Куда уходит событие. Всё — во вкладку «Ops» своего проекта; красное
- * приходит туда же, но со звуком.
+ * Where an event goes. Everything goes to its own project's "Ops" tab; a
+ * red one arrives there too, just with sound.
  *
- * Отдельной темы «инциденты» больше нет: она имела смысл, пока форум был
- * общий на все проекты. Теперь у каждого проекта своя группа, и авария
- * видна в его же ленте — сводить их в одно место незачем, а звук и так
- * отличает аварию от рядового сообщения.
+ * There is no separate "incidents" topic any more: it made sense while the
+ * forum was shared across all projects. Now every project has its own
+ * group, and an incident is visible in that same feed — there is no reason
+ * to funnel them into one place, and the sound already tells an incident
+ * apart from an ordinary message.
  */
 export const targets = (e) => {
     const forum = ROUTES[e.project];
-    // Неизвестный проект — опечатка в `--project` или проект, забытый в ROUTES.
-    // Возвращаем пустой список, а не падаем: уведомление не имеет права уронить
-    // вызвавший его деплой или крон (в bash с `set -e` падение было бы фатальным).
+    // An unknown project — a typo in `--project`, or a project forgotten in
+    // ROUTES. We return an empty list rather than throw: a notification has
+    // no right to bring down the deploy or cron job that called it (in bash
+    // with `set -e` a throw here would be fatal).
     if (!forum) {
         console.error(`[notify] unknown project "${e.project}" — known: ${Object.keys(ROUTES).join(', ')}`);
         return [];

package/dist/send.d.ts

@@ -1,21 +1,3 @@
-import type { NotifyEvent, Project } from './events.ts';
+import type { NotifyEvent } from './events.ts';
 export type SendResult = 'sent' | 'skipped' | 'failed';
 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, key?: string) => Promise<SendResult>;

package/dist/send.js

@@ -15,7 +15,7 @@
 import { execFileSync } from 'node:child_process';
 import { readFileSync } from 'node:fs';
 import { basename } from 'node:path';
-import { clampMessage, render, reportTags } from "./render.js";
+import { render } from "./render.js";
 import { ROUTES, targets } from "./routes.js";
 const log = (msg) => {
     // stderr, не stdout — stdout зарезервирован под возможный машинный вывод CLI.
@@ -133,7 +133,7 @@ const sendOne = async (token, target, text) => {
     log('out of send attempts');
     return 'failed';
 };
-/** Общий хвост для `notify` и `sendReport`: токен, цели, последовательная отправка. */
+/** The shared tail of `notify()`: token, targets, delivery one after another. */
 const deliver = async (where, text) => {
     const token = process.env.OPS_BOT_TOKEN?.trim();
     if (!token) {
@@ -285,34 +285,3 @@ export const notify = async (e) => {
     }
     return 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, key) => {
-    if (!Object.hasOwn(ROUTES, project)) {
-        // Та же красная карточка, что у notify(): дверь свободного HTML — не
-        // лазейка для молчаливой потери (этот класс уже жил неделями дважды).
-        await reportLostProject(project, 'report');
-        return 'skipped';
-    }
-    const forum = ROUTES[project];
-    // Без проекта — как и render.ts: карточка уже лежит в форуме своего
-    // проекта, дублировать его в теге незачем. Строка тегов ПЕРВАЯ и до обрезки,
-    // как у любой другой карточки.
-    const tags = reportTags(key ?? 'daily');
-    return deliver([{ chat: forum.chat, thread: forum.ops, silent: true }], `${tags}\n${clampMessage(html, Math.max(64, 4000 - tags.length - 1))}`);
-};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikitasazan/notify",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Единая типизированная отправка Telegram-уведомлений (форум-темы, маршрутизация, ретраи) для всех проектов",
   "type": "module",
   "license": "MIT",